비동기 비디오 생성 - CometAPI Documentation

POST

videos

Create a Veo video job

curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper kite floats above a field.' \
  --form input_reference='@example-file'

{
  "created_at": 1773297229,
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "model": "veo_3_1-4K",
  "object": "video",
  "progress": 0,
  "seconds": "",
  "size": "16x9",
  "status": "queued"
}

이 페이지를 사용해 공용 CometAPI /v1/videos 경로를 통해 Veo 작업을 시작할 수 있습니다. model 설정 시 모델 페이지에서 현재 Veo alias를 선택하세요.

요청 패턴 선택

텍스트-투-비디오: input_reference 파일을 보내지 않습니다
이미지-투-비디오: input_reference 하나를 보냅니다
첫 프레임 및 마지막 프레임 가이드: 순서가 있는 input_reference 파일 두 개를 보냅니다

작업 흐름

Veo 작업 제출

Veo alias, 프롬프트, 그리고 선택적 이미지 입력을 보낸 뒤 반환된 id를 저장합니다.

공용 비디오 엔드포인트 폴링

Veo3 Retrieve를 사용해 비동기 작업이 최종 상태에 도달할 때까지 추적합니다.

결과 저장

애플리케이션에서 영구 사본이 필요하다면 완료된 asset을 자체 스토리지로 옮기세요.

Alias 확인 방식

응답의 model 필드에는 제출한 alias가 아니라 확인된 백엔드 모델 id가 표시될 수 있습니다. 현재 Veo alias는 모델 페이지에서 확인하세요.

인증

Authorization

string

header

필수

Bearer token authentication. Use your CometAPI key.

본문

multipart/form-data

prompt

string

필수

Text prompt for the video job.

예시:

"A paper kite floats above a field."

model

string

기본값:veo3-fast

CometAPI Veo alias. Use a current Veo alias from the Models page. The response may resolve this alias to a provider model id.

예시:

"veo3-fast"

size

string

Orientation hint. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.

예시:

"16x9"

input_reference

file

Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.

응답

200 - application/json

Task accepted.

created_at

integer

필수

string

필수

model

string

필수

Provider model identifier resolved by CometAPI for this task.

object

string

필수

progress

integer

필수

seconds

string

필수

size

string

필수

status

string

필수

비디오 콘텐츠 가져오기

비디오 조회

Create a Veo video job

curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper kite floats above a field.' \
  --form input_reference='@example-file'

{
  "created_at": 1773297229,
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "model": "veo_3_1-4K",
  "object": "video",
  "progress": 0,
  "seconds": "",
  "size": "16x9",
  "status": "queued"
}

Documentation Index

​요청 패턴 선택

​작업 흐름

​Alias 확인 방식

인증

본문

응답

요청 패턴 선택

작업 흐름

Alias 확인 방식