Veo 動画 API

88API で Veo 3.1 動画タスクを作成・照会・ダウンロードする方法

88API の Veo エンドポイントは非同期方式です。最初にタスクを作成し、返されたタスク ID で状態を照会します。完了時には video_url が返されます。

ベース URL と認証

https://88api.ai

Authorization: Bearer sk-xxxx
Content-Type: application/json

利用可能なモデル

モデル	仕様	用途
`veo-3.1-fast-1080p-8s`	Veo 3.1 Fast、8 秒固定	速度優先
`veo-3.1-1080p-8s`	Veo 3.1 Standard、8 秒固定	品質優先

必ず上記の 88API モデル名を指定してください。レスポンスの model には変換後の上流モデル名が表示される場合があります。

1. タスクを作成

POST /v1/videos

フィールド	型	必須	説明
`model`	string	はい	上記のモデル名
`prompt`	string	はい	主体、動き、カメラ、照明、スタイルの説明
`size`	string	いいえ	推奨：`1920x1080` または `1080x1920`
`duration`	integer	いいえ	現在のモデルは 8 秒固定。`8` を指定してください
`images`	string[]	いいえ	画像 URL または Base64、最大 2 枚

curl --request POST 'https://88api.ai/v1/videos' \
  --header 'Authorization: Bearer sk-xxxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "veo-3.1-fast-1080p-8s",
    "prompt": "日の出の山岳地帯を飛行する映画的なドローン映像",
    "size": "1920x1080",
    "duration": 8
  }'

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "veo-3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1786106645
}

照会用に id を保存してください。クライアントのタイムアウト後に POST を無条件で再送すると、複数のタスクが作成・課金される可能性があります。

2. 状態を照会

GET /v1/videos/{id}

curl 'https://88api.ai/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'Authorization: Bearer sk-xxxx'

5～10 秒ごとに照会し、合計タイムアウトは 600 秒以上に設定してください。

状態	説明
`queued`	キュー待機中
`processing`	生成中
`completed`	`video_url` を取得
`failed`	`error` を確認

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "status": "completed",
  "video_url": "https://example-bucket.s3.amazonaws.com/video.mp4?..."
}

video_url は期限付き署名 URL です。完了後は速やかにダウンロードしてください。生の JSON に \u0026 が表示されても、JSON パーサーを使えば自動的に & へ復元されます。

ベース URL と認証

利用可能なモデル

1. タスクを作成

2. 状態を照会

目次