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 时 → 队列结果