Amux

Retrieve video task

最近更新：2026年9月7日

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

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

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

鉴权

header
Authorizationstring必填

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

请求

idstring必填

提交时返回的 Amux 任务 ID。

响应

200response

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

404response

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

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

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

新接入建议用统一取回口： 它带 usage 与 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.amux.ai/v2/query/video_generation/{id} \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "task": {
    "id": "<string>",
    "status": "queued",
    "content": {
      "url": "<string>"
    },
    "error": {
      "code": "<string>",
      "message": "<string>"
    }
  },
  "request_id": "<string>"
}