非同期動画生成 - CometAPI Documentation

POST

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 つ送信する

タスクの流れ

Veo ジョブを送信

Veo エイリアス、プロンプト、および任意の画像入力を送信し、返された id を保存します。

共通の動画エンドポイントをポーリング

非同期タスクが終了状態に到達するまで、Veo3 Retrieve を使って追跡します。

結果を保存

アプリケーションで永続的なコピーが必要な場合は、完了したアセットを自分のストレージに移動します。

エイリアスの解決

レスポンス内の model フィールドには、送信したエイリアスではなく、解決後のバックエンド model id が表示される場合があります。現在の Veo エイリアスは Models page で確認してください。

承認

Authorization

string

header

必須

Bearer token authentication. Use your CometAPI key.

ボディ

multipart/form-data

prompt

string

必須

Text prompt for the video job.

例:

"A paper kite floats above a field."

model

string

デフォルト:veo3-fast

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"

size

string

Orientation hint. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.

例:

"16x9"

input_reference

file

Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.

レスポンス

200 - application/json

Task accepted.

created_at

integer

必須

string

必須

model

string

必須

Provider model identifier resolved by CometAPI for this task.

object

string

必須

progress

integer

必須

seconds

string

必須

size

string

必須

status

string

必須

動画コンテンツを取得

動画を取得

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"
}

Documentation Index

​リクエストパターンを選ぶ

​タスクの流れ

​エイリアスの解決

承認

ボディ

レスポンス

リクエストパターンを選ぶ

タスクの流れ

エイリアスの解決