> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-feat-openapi-i18n.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Post proxyvidutext2video



## OpenAPI

````yaml /openapi/registry.ko.yaml post /proxy/vidu/text2video
openapi: 3.0.2
info:
  title: Comfy API
  version: '1.0'
servers:
  - url: https://api.comfy.org
security: []
paths:
  /proxy/vidu/text2video:
    post:
      tags:
        - API Nodes
        - Released
      operationId: ViduText2Video
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ViduTaskRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ViduTaskReply'
          description: 성공
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 오류 4xx/5xx
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 오류 4xx/5xx
components:
  schemas:
    ViduTaskRequest:
      properties:
        aspect_ratio:
          type: string
        audio:
          description: 직접 오디오-비디오 생성 기능 활성화 (q3 모델의 기본값은 참)
          type: boolean
        audio_type:
          description: >-
            오디오가 참일 때 오디오 유형: all (음향 효과 + 보컬), speech_only, sound_effect_only.
            q3 모델에는 효과 없음
          enum:
            - all
            - speech_only
            - sound_effect_only
          type: string
        bgm:
          description: 생성된 비디오에 배경 음악 추가 (q3 모델에는 효과 없음)
          type: boolean
        callback_url:
          description: 작업 상태 업데이트를 위한 콜백 URL
          type: string
        duration:
          description: >-
            비디오 지속 시간(초). viduq3-pro: 1-16, viduq2-pro-fast: 1-10,
            viduq2-pro/turbo: 1-8
          format: int32
          type: integer
        enhance:
          type: boolean
        images:
          description: img2video용 이미지 (시작 프레임으로 1개 이미지 허용)
          items:
            type: string
          type: array
        is_rec:
          description: 권장 프롬프트 사용 (추가 10 크레딧 소모)
          type: boolean
        meta_data:
          description: 메타데이터 식별, 사용자 정의 메타데이터를 위한 JSON 형식 문자열
          type: string
        model:
          description: >-
            모델 이름: viduq3-pro, viduq2-pro-fast, viduq2-pro, viduq2-turbo,
            viduq1, viduq1-classic, vidu2.0
          type: string
        movement_amplitude:
          description: 프레임 내 객체의 이동 진폭 (q2, q3 모델에는 효과 없음)
          enum:
            - auto
            - small
            - medium
            - large
          type: string
        off_peak:
          description: 오프 피크 모드 (저렴한 비용, 48시간 내 작업 생성)
          type: boolean
        payload:
          description: 투명 전송 파라미터 (최대 1048576자)
          type: string
        priority:
          format: int32
          type: integer
        prompt:
          description: 비디오 생성을 위한 텍스트 프롬프트 (최대 2000자)
          type: string
        resolution:
          description: '해상도: 360p, 540p, 720p, 1080p, 2K (사용 가능 여부는 모델 및 기간에 따라 다름)'
          type: string
        seed:
          description: 랜덤 시드 (지정하지 않으면 랜덤 기본값)
          format: int32
          type: integer
        style:
          enum:
            - general
            - anime
          type: string
        voice_id:
          description: 오디오용 음성 ID (q3 모델에는 효과 없음)
          type: string
        watermark:
          description: 비디오에 워터마크 추가 (기본값 거짓)
          type: boolean
        wm_position:
          description: '워터마크 위치: 1 (좌측 상단), 2 (우측 상단), 3 (우측 하단, 기본값), 4 (좌측 하단)'
          format: int32
          type: integer
        wm_url:
          description: 워터마크 이미지 URL (제공되지 않으면 기본 워터마크 사용)
          type: string
      type: object
    ViduTaskReply:
      properties:
        aspect_ratio:
          type: string
        bgm:
          description: 배경 음악 추가 여부
          type: boolean
        created_at:
          format: date-time
          type: string
        credits:
          format: int32
          type: integer
        duration:
          format: int32
          type: integer
        images:
          items:
            type: string
          type: array
        model:
          type: string
        movement_amplitude:
          enum:
            - auto
            - small
            - medium
            - large
          type: string
        off_peak:
          description: 비수 모드 상태
          type: boolean
        payload:
          description: 투명 전송 파라미터
          type: string
        prompt:
          type: string
        resolution:
          type: string
        seed:
          format: int32
          type: integer
        state:
          $ref: '#/components/schemas/ViduState'
        style:
          enum:
            - general
            - anime
          type: string
        task_id:
          type: string
        watermark:
          description: 워터마크 추가 여부
          type: boolean
      required:
        - task_id
        - state
        - credits
      type: object
    Error:
      properties:
        details:
          description: 오류에 대한 선택적 상세 정보 또는 해결을 위한 힌트.
          items:
            type: string
          type: array
        message:
          description: 오류에 대한 명확하고 간결한 설명.
          type: string
      type: object
    ViduState:
      enum:
        - created
        - processing
        - queueing
        - success
        - failed
      type: string

````