Veo 3 동영상 만들기

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

텍스트 또는 이미지로 Veo 3.1 동영상을 만듭니다. API는 즉시 작업 ID를 반환합니다. 작업을 폴링하고 완료된 동영상을 다운로드할 수 있도록 반환된 id 값을 저장하세요. POST /v1/videos 는 multipart/form-data을 사용합니다. 제어 항목은 폼 필드로 보내고 이미지는 input_reference 파일 필드로 전송합니다.

모델 선택

모델 ID	사용 시점	참고 사항
`veo3.1-fast`	대부분의 짧은 클립에 적합한 기본 선택	더 빠른 Veo 3.1 경로.
`veo3.1`	표준 Veo 3.1 모델을 특별히 원하는 경우 사용	표준 Veo 3.1 경로.

입력 모드 선택

목표	필수 필드	선택 필드
텍스트-동영상	`model`, `prompt`	`seconds`, `size`
이미지-동영상	`model`, `prompt`, `input_reference` 이미지 파일 하나	`seconds`, `size`

이미지를 애니메이션화하려면 input_reference을 통해 파일 하나를 업로드하고 이 필드는 한 번만 사용하세요. 이미지는 시작 프레임을 설정하며, prompt은 이후의 움직임과 카메라 동작을 설명합니다.

재생 시간 및 크기 설정

이 OpenAI 호환 경로에서는 명시적 정수 seconds 값으로 재생 시간을 설정하고 size로 출력 크기를 설정하세요. 두 값 모두 폼 필드로 전송합니다.

모델 ID	`seconds`	기본값
`veo3.1-fast`	`4`, `6`, `8`	`4` 초, `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` 초, `1280x720`

size을 아래 WxH 값 중 하나로 설정하세요.

해상도 등급	가로세로비	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

작업 흐름

작업 생성

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

작업 폴링

다음 Veo3 Retrieve 를 사용하여 status이 completed, failed 또는 error이 될 때까지 폴링하세요.

결과 다운로드

작업이 completed 상태가 되면 완료된 작업 응답에서 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<integer>

기본값:4

Requested clip duration in whole seconds. Send 4, 6, or 8 as a form field.

사용 가능한 옵션:

4,

6,

8

예시:

4

size

string

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

예시:

"1280x720"

input_reference

file

One image file that sets the opening frame for image-to-video. Send input_reference once with one file. Use prompt to describe the motion and camera behavior that follow.

응답

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.

예시:

"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.

마지막 수정일 2026년 9월 9일

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

콘텐츠 검토

API 키

모델 선택

입력 모드 선택

재생 시간 및 크기 설정

작업 흐름

인증

본문

응답

​모델 선택

​입력 모드 선택

​재생 시간 및 크기 설정

​작업 흐름

인증

본문

응답

모델 선택

입력 모드 선택

재생 시간 및 크기 설정

작업 흐름