動画生成タスクを取得

動画生成タスクのステータスと結果を取得します。 タスクのステータス: - queued: キュー待ち - in_progress: 生成中 - completed: 完了 - failed: 失敗

GET /v1/video/generations/{task_id}

サービスルート: https://getrouter.ai

プロトコル: 動画タスク API

認証: Authorization: Bearer YOUR_API_KEY

パラメータ

パラメータ場所必須説明
task_idpathstringはいタスク ID

リクエスト例

curl --request GET \
  --url https://getrouter.ai/v1/video/generations/TASK_ID \
  --header "Authorization: Bearer YOUR_API_KEY"

レスポンス

ステータス説明
200タスクのステータスを正常に取得
404タスクが存在しません

成功レスポンスのフィールド

フィールド必須説明
task_idstringいいえタスク ID
statusstringいいえタスクのステータス 選択肢: queued, in_progress, completed, failed
urlstringいいえ動画リソース URL(成功時)
formatstringいいえ動画形式
metadataobjectいいえ
errorobjectいいえ

レスポンス例

{
  "task_id": "TASK_ID",
  "status": "queued",
  "url": "https://example.com/resource",
  "format": "mp3",
  "metadata": {
    "duration": 1,
    "fps": 1,
    "width": 1,
    "height": 1,
    "seed": 1
  },
  "error": {
    "code": 1,
    "message": "string"
  }
}

関連ガイド

詳しいワークフローと例については、動画生成 API ガイドを参照してください。


このページは公開 Relay OpenAPI 仕様から自動生成されています。仕様全体は API Explorer で確認できます。