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

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

動画生成タスクの軽量なステータス確認です。課金は発生しません。 ポーリングにはこのエンドポイントを使用してください。

リクエスト

パスパラメーター

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

ヘッダー

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

レスポンス

{
  "request_id": "Z2VtaW5pOnZlby0zOjg6NzIwcDoxOm9wLTEyMzQ1",
  "status": "IN_PROGRESS"
}

フィールド	型	説明
`request_id`	`string`	リクエスト ID。
`status`	`string`	現在のタスク状態。
`error`	`string`	エラーメッセージ（`FAILED` の場合のみ）。

ステータス値

ステータス	説明
`IN_QUEUE`	タスクを受け付け、処理待ち
`IN_PROGRESS`	動画を生成中
`COMPLETED`	生成完了 — 完全な結果を取得できます
`FAILED`	生成失敗 — `error` フィールドを確認してください

このエンドポイントはステータスメタデータのみを返します。動画のダウンロード URL を取得して課金を発生させるには、ステータスが COMPLETED になった後にキュー結果エンドポイントを使用してください。

ステータスコード

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

例

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

import time
import requests

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

while True:
    resp = requests.get(f"{BASE}{task['status_url']}", headers=headers)
    status = resp.json()
    print(f"Status: {status['status']}")

    if status["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(5)

const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));

let done = false;
while (!done) {
  await sleep(5000);
  const resp = await fetch(`${BASE_URL}${task.status_url}`, {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });
  const status = await resp.json();
  console.log("Status:", status.status);
  done = status.status === "COMPLETED" || status.status === "FAILED";
}

次のステップ

ステータスが COMPLETED になったら → キュー結果