Veo 3 비디오 생성하기
CometAPI를 통해 POST /v1/videos로 Veo 3.1 비디오를 비동기적으로 생성한 다음, task를 폴링하고 완료된 MP4 파일을 다운로드합니다.
id를 저장하고 최종 상태에 도달할 때까지 task를 폴링하세요.
POST /v1/videos는 multipart/form-data를 사용합니다. 스칼라 제어 값은 form 필드로 전달하고, 미디어 입력은 input_reference 파일 필드로 전달하세요.
모델 선택하기
입력 모드 선택하기
길이와 크기 설정하기
OpenAI 호환 경로에서는 길이에seconds, 출력 크기에 size를 사용합니다. 값은 form 필드로 전송하세요.
size는 아래 WxH 값 중 하나로 설정하세요.
Task 흐름
task 생성
id를 저장합니다.task 폴링
status가 completed, failed, 또는 error가 될 때까지 Veo3 Retrieve를 사용하세요.결과 다운로드
completed 상태가 되면 완료된 task 응답에서 MP4 파일을 다운로드하세요.인증
Bearer authentication. Use your CometAPI API key.
본문
Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.
veo3.1-fast, veo3.1 "veo3.1-fast"
Text prompt for the video job.
"A paper kite floats above a field."
Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.
4, 6, 8 "4"
Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.
"1280x720"
Optional first-frame image file for image-to-video.
응답
Task created. Store the returned id and poll GET /v1/videos/{task_id}.
Task ID. Use this value with retrieve and content endpoints.
"task_example"
Object type. Video tasks return video.
"video"
Model ID used for the task.
"veo3.1-fast"
Task lifecycle status. Poll until the value is completed, failed, or error.
queued, in_progress, completed, failed, error "queued"
Task progress as a coarse percentage.
0 <= x <= 1000
Task creation time as a Unix timestamp in seconds.
1779938152
Compatibility alias for id when present.
"task_example"
Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.
1779938219
Temporary video delivery URL. This field appears on completed tasks.
"<temporary-video-url>"
Failure details. This field appears when the task fails.