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 page から現在の Veo エイリアスを選択してください。
リクエストパターンを選ぶ
- テキストから動画:
input_referenceファイルは送信しない - 画像から動画:
input_referenceを 1 つ送信する - 先頭フレームと末尾フレームのガイダンス: 順序付けされた
input_referenceファイルを 2 つ送信する
タスクの流れ
共通の動画エンドポイントをポーリング
非同期タスクが終了状態に到達するまで、Veo3 Retrieve を使って追跡します。
エイリアスの解決
レスポンス内のmodel フィールドには、送信したエイリアスではなく、解決後のバックエンド model id が表示される場合があります。現在の Veo エイリアスは Models page で確認してください。承認
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"
}