CometAPI 래퍼
비동기 비디오 생성
CometAPI에서 POST /v1/videos를 통해 Veo3 비디오를 비동기로 생성하며, task id를 반환하고 8초 클립에 대한 첫 프레임/마지막 프레임 가이드를 지원합니다.
POST
/
v1
/
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을 설정할 때는 Models 페이지에서 현재 Veo alias를 선택하세요.
요청 패턴 선택
- 텍스트-투-비디오:
input_reference파일을 보내지 않습니다 - 이미지-투-비디오:
input_reference하나를 보냅니다 - 첫 프레임 및 마지막 프레임 가이드: 순서가 지정된
input_reference파일 두 개를 보냅니다
작업 흐름
공용 비디오 엔드포인트 폴링
비동기 작업이 최종 상태에 도달할 때까지 Veo3 Retrieve를 사용해 추적합니다.
alias 확인 방식
Google은 Gemini의 장기 실행 비디오 작업을 통해 Veo를 문서화하며veo-3.1-generate-preview와 같은 model 이름을 사용합니다. CometAPI는 공용 /v1/videos 경로를 유지하면서 요청 시점에 Models 페이지에서 현재 Veo alias를 확인합니다. 2026-03-12의 실제 검증 과정에서는 veo3-fast를 사용한 요청이 허용되어 비동기 task id를 반환했으며, 응답의 model은 제출한 alias를 그대로 되돌리는 대신 provider model id로 확인되었습니다.인증
Bearer token authentication. Use your CometAPI key.
본문
multipart/form-data
Text prompt for the video job.
예시:
"A paper kite floats above a field."
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"
Orientation hint used by the wrapper. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.
예시:
"16x9"
Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.
⌘I
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"
}