RouterOne

Retrieve video task

最近更新：2026年10月30日

按 MiniMax 原生形状查 minimax/minimax-h3-max 的任务结果。

按 MiniMax 的形状查 minimax/minimax-h3-max 的任务。

GEThttps://gateway.routerone.ai/v2/query/video_generation/{id}

鉴权

header
Authorizationstring必填

Bearer <你的 RouterOne 密钥> 站内 API Key。

请求

idstring必填

提交时返回的 RouterOne 任务 ID。

响应

200response

无论跑没跑完都是 200，状态在 task.status 里。

404response

当前工作区里没有这个任务。

它和统一取回口查的是同一个任务

一张任务表、一个 ID、一份数据，只在最后按两种形状渲染。提供它是因为 MiniMax 客户端会自行拼接这个地址——不提供的话，换了 base_url 之后会出现提交成功 而取回 404。

响应字段与 MiniMax 官方查询接口一致：除状态、产物与失败原因外，还包括 model、 created_at / updated_at、resolution、duration、ratio、task_type、modality 与 usage。usage 中上游提供的字段原样返回（如 token 计数、参考音频秒数）， 未提供的不返回。本次扣费金额（cost）只在统一取回口中提供。

状态

无论是否完成均返回 200，状态在 task.status 里。

task.status含义是否计费
queued排队中——
running生成中——
succeeded已完成，产物在 task.content.url按实际用量计费
failed上游拒绝或出错不计费，预扣已释放
cancelled已取消不计费，预扣已释放

⚠️ cancelled 是两个 l，与上游一致。

轮询节奏

视频生成的耗时由排队主导，与请求时长不成正比。建议提交后 20 秒内不查询， 之后每 10–15 秒一次——上游给的建议间隔是 10 秒。不要按输出时长线性估算超时。

产物地址

task.content.url 指向我们的存储，不是上游那个带供应商签名、会过期的临时地址。 该地址会被定期清理，需要长期保存请及时下载。

cURL
curl https://gateway.routerone.ai/v2/query/video_generation/{id} \
  -H "Authorization: Bearer $ROUTERONE_API_KEY"
{
  "task": {
    "id": "<string>",
    "model": "<string>",
    "status": "queued",
    "content": {
      "url": "<string>"
    },
    "error": {
      "code": "<string>",
      "message": "<string>"
    },
    "created_at": 0,
    "updated_at": 0,
    "resolution": "768P",
    "duration": 5,
    "usage": {
      "total_seconds": 0,
      "input_seconds": 0,
      "output_seconds": 0,
      "input_image_count": 0,
      "input_audio_seconds": 0,
      "total_tokens": 0,
      "prompt_tokens": 0,
      "completion_tokens": 0
    },
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video"
  },
  "request_id": "<string>"
}