Veo 3 動画を作成する
CometAPI で POST /v1/videos を使って Veo 3.1 動画を非同期に生成し、その後タスクをポーリングして完了した MP4 ファイルをダウンロードします。
id を保存し、タスクが終端ステータスに到達するまでポーリングしてください。
POST /v1/videos は multipart/form-data を使用します。スカラー制御はフォームフィールドとして渡し、メディア入力は input_reference ファイルフィールドとして渡します。
モデルを選ぶ
入力モードを選ぶ
時間とサイズを設定する
OpenAI 互換ルートでは、時間にはseconds を使用し、出力サイズには size を使用します。値はフォームフィールドとして送信してください。
size は以下の WxH 値のいずれかに設定してください。
タスクの流れ
タスクを作成する
id を保存します。タスクをポーリングする
status が completed、failed、または error になるまで Veo3 Retrieve を使用します。結果をダウンロードする
completed になったら、完了したタスクレスポンスから MP4 ファイルをダウンロードします。承認
Bearer authentication. Use your CometAPI API key.
ボディ
Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.
veo3.1-fast, veo3.1 "veo3.1-fast"
Text prompt for the video job.
"A paper kite floats above a field."
Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.
4, 6, 8 "4"
Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.
"1280x720"
Optional first-frame image file for image-to-video.
レスポンス
Task created. Store the returned id and poll GET /v1/videos/{task_id}.
Task ID. Use this value with retrieve and content endpoints.
"task_example"
Object type. Video tasks return video.
"video"
Model ID used for the task.
"veo3.1-fast"
Task lifecycle status. Poll until the value is completed, failed, or error.
queued, in_progress, completed, failed, error "queued"
Task progress as a coarse percentage.
0 <= x <= 1000
Task creation time as a Unix timestamp in seconds.
1779938152
Compatibility alias for id when present.
"task_example"
Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.
1779938219
Temporary video delivery URL. This field appears on completed tasks.
"<temporary-video-url>"
Failure details. This field appears when the task fails.