Skip to Content

動画生成

文章での説明から動画を生成するAPIです。 完成までに時間がかかるので、リクエストを送ったあとに状況を確認し、完了してからダウンロードします。

手順

  1. POST /v1/videosで、動画の生成をリクエストします。動画の id が返ります。
  2. GET /v1/videos/{video_id}で、生成状況を取得します。status が completed になるまで繰り返します。
  3. GET /v1/videos/{video_id}/contentで、動画をダウンロードします。

モデルを選ぶ

使えるのは、GET /v1/models が返すモデルのうち、output_modality が video のモデルです。 料金はモデルの一覧ページで確認できます。

Seedance(BytePlusのモデル)を使うには、自分で契約したBytePlusのAPIキーの登録(BYOK)が必要です。

動画を生成する

model と、生成する動画の説明(prompt)を送ります。

Shell
curl "https://ai-gateway.lolipop.jp/v1/videos" \ -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "google/veo-3.1-fast-generate-001", "prompt": "日の出の湖に浮かぶ小さなヨット", "seconds": "8", "parameters": { "sampleCount": 1, "resolution": "720p", "generateAudio": true } }'

レスポンスで動画の id が返ります。

JSON
{ "id": "video_abc123", "object": "video", "status": "processing" }

モデルごとのパラメーターは、Veo(Googleのモデル)では parameters、Seedanceでは extra_body に指定します。 指定できる値は、APIリファレンスの動画生成を参照してください。

生成状況を確認する

受け取った id で生成状況を取得します。 APIキーは、動画を生成したときと同じプロジェクトのものを使ってください。

Shell
curl "https://ai-gateway.lolipop.jp/v1/videos/video_abc123" \ -H "Authorization: Bearer $AI_GATEWAY_API_KEY"

status が completed になるまで、時間をおいて繰り返します。

JSON
{ "id": "video_abc123", "object": "video", "status": "completed", "usage": { "video_count": 1 } }
status状態
processing、queued、in_progress生成中です。値はモデルによって異なります
completed完了です。生成に成功した動画の本数が usage.video_count に入ります
failed失敗です

completed でも、usage.video_count が 0 の場合は動画が生成されていません。 生成に失敗した分の費用はかかりません。

動画をダウンロードする

status が completed になったら、動画の id を指定してダウンロードします。

Shell
curl "https://ai-gateway.lolipop.jp/v1/videos/video_abc123/content?index=0" \ -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \ -o video.mp4

複数の動画を生成した場合は、index に何本目かを0始まりで指定します。

ロリポップ!AIゲートウェイは動画を保管しないので、生成が完了したらダウンロードして保存してください。 Seedanceで生成した動画は、生成から24時間を過ぎるとダウンロードできなくなります。