API 레퍼런스
통합 가이드
라이브러리
요금 및 결제
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 설정 시 모델 페이지에서 현재 Veo alias를 선택하세요.
요청 패턴 선택
- 텍스트-투-비디오:
input_reference파일을 보내지 않습니다 - 이미지-투-비디오:
input_reference하나를 보냅니다 - 첫 프레임 및 마지막 프레임 가이드: 순서가 있는
input_reference파일 두 개를 보냅니다
작업 흐름
공용 비디오 엔드포인트 폴링
Veo3 Retrieve를 사용해 비동기 작업이 최종 상태에 도달할 때까지 추적합니다.
Alias 확인 방식
응답의model 필드에는 제출한 alias가 아니라 확인된 백엔드 모델 id가 표시될 수 있습니다. 현재 Veo alias는 모델 페이지에서 확인하세요.인증
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. 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"
}