#動画

動画生成は非同期です。タスクを作成して ID を保存し、タスクの状態をポーリングして、完了後に結果をダウンロードします。

一般的な動画エンドポイントは次のとおりです。

POST /v1/videos
GET  /v1/videos/{task_id}
GET  /v1/videos/{task_id}/content

#動画タスクを作成する

/v1/videos エンドポイントは multipart form data を受け付けます。

curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=静かな現代的オフィスを飛ぶ紙飛行機" \
  -F "seconds=8"

画像から動画を生成する場合は、モデルが対応していれば参照ファイルを含めます。

curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=ゆっくりとカメラを寄せ、控えめな動きを加える" \
  -F "seconds=8" \
  -F "[email protected]"

成功したレスポンスには id などのタスク識別子と、利用可能な場合はステータス、進捗、モデル、長さ、タイムスタンプなどのタスクメタデータが含まれます。

#タスクの状態を確認する

curl https://getrouter.ai/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

適切な間隔でポーリングします。タスクが成功または失敗の終端状態になったらポーリングを停止してください。

#結果をダウンロードする

タスクの完了後：

curl -L https://getrouter.ai/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output result.mp4

#推奨するタスクワークフロー

1. 送信前にモデル、長さ、入力を検証する。
2. タスクを一度だけ送信する。
3. 返されたタスク ID を永続化する。
4. 短い間隔で繰り返しリクエストせず、バックオフ付きでポーリングする。
5. トラブルシューティングのために終端エラーを記録する。
6. 完了したコンテンツを速やかにダウンロードする。

#プロバイダー固有の動画 API

API 仕様には、Kling 形式など、プロバイダー互換の動画パスも含まれます。リクエストフィールドとステータスレスポンスはエンドポイントごとに異なります。モデルや既存クライアントがプロバイダー固有のパスを必要とする場合を除き、新しい連携では一般的な /v1/videos フローを使用してください。

現在公開されているパスとスキーマについては、API リファレンスを参照してください。

#コスト管理

動画の料金は、モデル、長さ、解像度、品質、入力タイプによって異なる場合があります。料金を確認し、自動バッチを実行する前に短いテストジョブから始めてください。

#次のステップ

• 動画モデルを見る
• 料金を確認する
• API リファレンスを開く