GET /v1/queue/{model}/requests/{requestID}

GET/v1/queue/{model}/requests/{requestID}

動画生成タスクの完全な結果を返します。ダウンロード URL と usage を含みます。ステータスが COMPLETED の場合、この呼び出しで課金が発生します。

リクエスト

パスパラメーター

パラメーター	型	説明
`model`	`string`	動画モデル ID（例: `veo-3`）。
`requestID`	`string`	送信レスポンスで返されたリクエスト ID。

ヘッダー

ヘッダー	値
`Authorization`	`Bearer {api_key}`

レスポンス

`COMPLETED` の場合

{
  "request_id": "Z2VtaW5pOnZlby0zOjg6NzIwcDoxOm9wLTEyMzQ1",
  "status": "COMPLETED",
  "model": "veo-3",
  "data": [
    { "url": "/v1/queue/veo-3/requests/Z2Vt.../content/0" }
  ],
  "usage": {
    "video_seconds": 8,
    "video_resolution": "720p",
    "video_has_audio": true
  }
}

まだ処理中の場合

{
  "request_id": "...",
  "status": "IN_PROGRESS",
  "model": "veo-3"
}

失敗した場合

{
  "request_id": "...",
  "status": "FAILED",
  "model": "veo-3",
  "error": "content policy violation"
}

レスポンスフィールド

フィールド	型	説明
`request_id`	`string`	リクエスト ID。
`status`	`string`	`IN_QUEUE`、`IN_PROGRESS`、`COMPLETED`、または `FAILED`。
`model`	`string`	モデル ID。
`data[].url`	`string`	コンテンツエンドポイントへの相対パス。
`usage.video_seconds`	`number`	生成された動画の長さ。
`usage.video_resolution`	`string`	`"720p"`、`"1080p"`、または `"4k"`。
`usage.video_has_audio`	`boolean`	音声が生成されたかどうか。
`error`	`string`	エラー説明（`FAILED` の場合のみ）。

このエンドポイントを呼び出し、タスクが COMPLETED の場合に課金が発生します。ポーリングには軽量なステータスエンドポイントを使用し、結果を消費する準備ができたときだけこのエンドポイントを呼び出してください。

ステータスコード

ステータス	説明
`200`	成功
`400`	不正なリクエスト ID、またはプロバイダー不一致
`401`	認証なし
`502`	上流プロバイダーエラー

例

curl https://api.modelmax.io/v1/queue/veo-3/requests/{request_id} \
  -H "Authorization: Bearer $MODELMAX_API_KEY"

import requests

BASE = "https://api.modelmax.io"
headers = {"Authorization": "Bearer your-key"}

result = requests.get(f"{BASE}{task['response_url']}", headers=headers).json()

if result["status"] == "COMPLETED":
    for i, video in enumerate(result["data"]):
        print(f"Video {i}: {video['url']}")
    print(f"Usage: {result['usage']}")
elif result["status"] == "FAILED":
    print(f"Error: {result['error']}")

const resultResp = await fetch(`${BASE_URL}${task.response_url}`, {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
const result = await resultResp.json();

if (result.status === "COMPLETED") {
  console.log("Videos:", result.data);
  console.log("Usage:", result.usage);
}

次のステップ

動画をダウンロードする → キュー内容