Vidu 비디오 생성 - CometAPI Documentation

이 엔드포인트를 사용하여 Vidu Q3 텍스트-비디오 또는 이미지-비디오 작업을 생성하세요. API는 즉시 작업 ID를 반환하므로, 반환된 id을 저장하고 작업이 최종 상태에 도달할 때까지 폴링하세요. POST /v1/videos 이 엔드포인트는 multipart/form-data을 사용합니다. 스칼라 제어 값은 양식 필드로 전송하고, 참조 이미지는 input_reference 파일 필드로 지정하세요.

입력 모드 선택

목표	필수 필드	선택 필드
텍스트-비디오	`model`, `prompt`	`seconds`, `size`
이미지-비디오	`model`, `prompt`, `input_reference` 파일 1개	`seconds`, `size`

API 키에서 사용할 수 있는 Vidu 모델 ID를 확인하려면 사용 가능한 모델 나열.

참조 이미지 사용

이미지-비디오의 경우 input_reference multipart 필드를 통해 참조 이미지 하나를 업로드하세요. 파일 크기는 최대 20 MB입니다. 이미지는 생성된 비디오의 구도와 외관을 안내합니다. 프롬프트(Prompt)를 사용하여 동작, 카메라 동작, 그리고 비디오가 유지해야 하는 세부 사항을 설명하세요.

길이 및 크기 설정

모델 ID	`seconds`	기본값
`viduq3-turbo`	정수 `1`-`16`	`5` 초, `1280x720`
`viduq3`	정수 `1`-`16`	`5` 초, `1280x720`

아래 WxH 값 중 하나를 사용하도록 size을 설정하세요.

해상도 등급	화면비	`size` (`WxH`)
`540p`	`16:9`	`960x528`
`720p`	`16:9`	`1280x720`
`1080p`	`16:9`	`1920x1080`

작업 흐름

작업 생성

multipart 양식 요청을 전송하고 반환된 id을 저장하세요.

작업 폴링

다음 Vidu 비디오 검색 을 status 상태가 completed, failed 또는 error이 될 때까지 호출하세요.

결과 다운로드

작업 상태가 completed이면 다음 Vidu 비디오 콘텐츠 검색 을 호출하여 MP4 파일을 다운로드하세요.

인증

Authorization

string

header

필수

Bearer authentication. Use your CometAPI API key.

본문

multipart/form-data

model

string

필수

Vidu Q3 model ID for this route. Choose an available model from the Models page.

예시:

"viduq3-turbo"

prompt

string

필수

Text prompt that describes the video to generate. For image-to-video, describe the motion and camera behavior that should animate the reference image.

예시:

"An astronaut walks through soft blue fog with a slow cinematic camera move."

seconds

string

Requested clip duration in seconds. Use an integer from 1 through 16. Default is 5.

예시:

"1"

size

string

Supported WxH size values: 960x528, 1280x720, 1920x1080. Default is 1280x720.

input_reference

file

One reference image file for image-to-video. Omit this field for text-to-video. The file can be up to 20 MB. The image guides the composition and appearance of the generated video.

응답

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

string

필수

Task ID. Use this value with retrieve and content endpoints.

예시:

"task_example"

object

string

필수

Object type. Video tasks return video.

예시:

"video"

model

string

필수

Model ID used for the task.

예시:

"viduq3-turbo"

status

enum<string>

필수

Task lifecycle status. Poll until the value is completed, failed, or error.

사용 가능한 옵션:

queued,

in_progress,

completed,

failed,

error

예시:

"queued"

progress

integer

필수

Task progress as a coarse percentage.

필수 범위: 0 <= x <= 100

예시:

0

created_at

integer

필수

Task creation time as a Unix timestamp in seconds.

예시:

1779938152

task_id

string

Compatibility alias for id when present.

예시:

"task_example"

completed_at

integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

예시:

1779938219

video_url

string

Temporary video delivery URL. This field appears on completed tasks.

예시:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

​입력 모드 선택

​참조 이미지 사용

​길이 및 크기 설정

​작업 흐름

인증

본문

응답

입력 모드 선택

참조 이미지 사용

길이 및 크기 설정

작업 흐름