Skip to main content
POST
cURL
이 엔드포인트를 사용해 Veo 3.1 비디오 task를 시작할 수 있습니다. API는 즉시 task ID를 반환하므로, 반환된 id를 저장하고 최종 상태에 도달할 때까지 task를 폴링하세요. POST /v1/videosmultipart/form-data를 사용합니다. 스칼라 제어 값은 form 필드로 전달하고, 미디어 입력은 input_reference 파일 필드로 전달하세요.

모델 선택하기

입력 모드 선택하기

길이와 크기 설정하기

OpenAI 호환 경로에서는 길이에 seconds, 출력 크기에 size를 사용합니다. 값은 form 필드로 전송하세요. size는 아래 WxH 값 중 하나로 설정하세요.

Task 흐름

1

task 생성

multipart form 요청을 전송하고 반환된 id를 저장합니다.
2

task 폴링

statuscompleted, failed, 또는 error가 될 때까지 Veo3 Retrieve를 사용하세요.
3

결과 다운로드

task가 completed 상태가 되면 완료된 task 응답에서 MP4 파일을 다운로드하세요.

인증

Authorization
string
header
필수

Bearer authentication. Use your CometAPI API key.

본문

multipart/form-data
model
enum<string>
필수

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"

prompt
string
필수

Text prompt for the video job.

예시:

"A paper kite floats above a field."

seconds
enum<string>
기본값:4

Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.

사용 가능한 옵션:
4,
6,
8
예시:

"4"

size
string

Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.

예시:

"1280x720"

input_reference
file

Optional first-frame image file for image-to-video.

응답

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

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.

예시:

"veo3.1-fast"

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.