Veo 3 動画を作成

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

テキストまたは画像から Veo 3.1 動画を作成します。API は直ちにタスク ID を返します。返された id を保存して、タスクをポーリングし、完了した動画をダウンロードします。 POST /v1/videos では multipart/form-data を使用します。コントロールはフォームフィールドとして送信し、画像は input_reference ファイルフィールドとして送信します。

モデルを選択

モデル ID	使用する場合	注記
`veo3.1-fast`	ほとんどの短いクリップに適したデフォルトの選択肢	より高速な Veo 3.1 ルート。
`veo3.1`	標準の Veo 3.1 モデルを特に使用したい場合に使用	標準 Veo 3.1 ルート。

入力モードを選択

目的	必須フィールド	任意フィールド
テキストから動画	`model`, `prompt`	`seconds`, `size`
画像から動画	`model`, `prompt`、`input_reference` の画像ファイル 1 つ	`seconds`, `size`

画像をアニメーション化するには、input_reference を介してファイルを 1 つアップロードし、このフィールドを 1 回使用します。画像が開始フレームを設定し、prompt でその後の動きとカメラの挙動を指定します。

長さとサイズを設定

この OpenAI 互換ルートでは、明示的な整数の seconds 値で長さを設定し、size で出力サイズを設定します。両方の値をフォームフィールドとして送信します。

モデル ID	`seconds`	デフォルト
`veo3.1-fast`	`4`, `6`, `8`	`4` 秒、 `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` 秒、 `1280x720`

size を以下の WxH 値のいずれかに設定します。

解像度レベル	アスペクト比	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

タスクフロー

タスクを作成

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

タスクをポーリング

次の Veo3 Retrieve を使用して、status が completed、failed、または error になるまでポーリングします。

結果をダウンロード

タスクが 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<integer>

デフォルト:4

Requested clip duration in whole seconds. Send 4, 6, or 8 as a form field.

利用可能なオプション:

4,

6,

8

例:

4

size

string

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

例:

"1280x720"

input_reference

file

One image file that sets the opening frame for image-to-video. Send input_reference once with one file. Use prompt to describe the motion and camera behavior that follow.

レスポンス

Task created. Store the returned id and poll GET /v1/videos/{task_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.

最終更新日 2026年9月9日

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

コンテンツモデレーション

APIキー

モデルを選択

入力モードを選択

長さとサイズを設定

タスクフロー

承認

ボディ

レスポンス

​モデルを選択

​入力モードを選択

​長さとサイズを設定

​タスクフロー

承認

ボディ

レスポンス

モデルを選択

入力モードを選択

長さとサイズを設定

タスクフロー