Background texture
ModelMax

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

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

返回视频生成任务的完整结果，包括下载 URL 和用量信息。当状态为 COMPLETED 时会触发计费。

请求

路径参数

参数类型描述
modelstring视频模型 ID（如 veo-3）。
requestIDstring来自提交响应的请求 ID。

请求头

请求头值
AuthorizationBearer {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_idstring请求 ID。
statusstringIN_QUEUE、IN_PROGRESS、COMPLETED 或 FAILED。
modelstring模型 ID。
data[].urlstring指向内容端点的相对路径。
usage.video_secondsnumber生成视频的时长。
usage.video_resolutionstring"720p"、"1080p" 或 "4k"。
usage.video_has_audioboolean是否生成了音频。
errorstring错误描述（仅当 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);
}

下一步

下载视频 → 队列内容