Skip to main content
POST
cURL
このエンドポイントを使用して、Veo 3.1 の動画タスクを開始します。API はタスク ID を即座に返すため、返された id を保存し、タスクが終端ステータスに到達するまでポーリングしてください。 POST /v1/videosmultipart/form-data を使用します。スカラー制御はフォームフィールドとして渡し、メディア入力は input_reference ファイルフィールドとして渡します。

モデルを選ぶ

入力モードを選ぶ

時間とサイズを設定する

OpenAI 互換ルートでは、時間には seconds を使用し、出力サイズには size を使用します。値はフォームフィールドとして送信してください。 size は以下の WxH 値のいずれかに設定してください。

タスクの流れ

1

タスクを作成する

multipart フォームリクエストを送信し、返された id を保存します。
2

タスクをポーリングする

statuscompletedfailed、または error になるまで Veo3 Retrieve を使用します。
3

結果をダウンロードする

タスクが completed になったら、完了したタスクレスポンスから MP4 ファイルをダウンロードします。

承認

Authorization
string
header
必須

Bearer authentication. Use your CometAPI API key.

ボディ

multipart/form-data
model
enum<string>
必須

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"

prompt
string
必須

Text prompt for the video job.

:

"A paper kite floats above a field."

seconds
enum<string>
デフォルト:4

Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.

利用可能なオプション:
4,
6,
8
:

"4"

size
string

Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.

:

"1280x720"

input_reference
file

Optional first-frame image file for image-to-video.

レスポンス

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

id
string
必須

Task ID. Use this value with retrieve and content endpoints.

:

"task_example"

object
string
必須

Object type. Video tasks return video.

:

"video"

model
string
必須

Model ID used for the task.

:

"veo3.1-fast"

status
enum<string>
必須

Task lifecycle status. Poll until the value is completed, failed, or error.

利用可能なオプション:
queued,
in_progress,
completed,
failed,
error
:

"queued"

progress
integer
必須

Task progress as a coarse percentage.

必須範囲: 0 <= x <= 100
:

0

created_at
integer
必須

Task creation time as a Unix timestamp in seconds.

:

1779938152

task_id
string

Compatibility alias for id when present.

:

"task_example"

completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

:

1779938219

video_url
string

Temporary video delivery URL. This field appears on completed tasks.

:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.