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 alias を選択してください。
リクエストパターンを選ぶ
- テキストから動画:
input_referenceファイルは送信しません - 画像から動画:
input_referenceを 1 つ送信します - 先頭フレームと末尾フレームのガイダンス: 順序付きの
input_referenceファイルを 2 つ送信します
タスクフロー
共有動画エンドポイントをポーリング
Veo3 Retrieve を使って、非同期タスクが終了状態に達するまで追跡します。
alias の解決
Google は Gemini の長時間実行される動画オペレーションを通じて Veo を文書化しており、veo-3.1-generate-preview のような model 名を使用しています。CometAPI は共有の /v1/videos ルートを維持し、リクエスト時に Models page から現在の 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"
}