動画生成
文章での説明から動画を生成するAPIです。 完成までに時間がかかるので、リクエストを送ったあとに状況を確認し、完了してからダウンロードします。
手順
POST /v1/videosで、動画の生成をリクエストします。動画のidが返ります。GET /v1/videos/{video_id}で、生成状況を取得します。statusがcompletedになるまで繰り返します。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時間を過ぎるとダウンロードできなくなります。