Amux

Retrieve video generation task

最近更新：2026年9月6日

按 MiniMax 原生形状查询视频任务。它是别名，和站内统一取回口查的是同一个任务。

按提交时返回的 ID 查询一个视频任务，响应为 MiniMax 的形状。

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

鉴权

header
Authorizationstring必填

Bearer <你的 Amux 密钥> 控制台创建的 Amux 密钥。忘了可以回控制台的密钥页再看一次。

请求

idstring必填

提交时返回的 Amux 任务 ID。

响应

200response

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

404response

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

与站内统一取回端点的关系

该端点与 GET /v1/tasks/{id} 查询的是同一个 任务：同一张任务表、同一个 ID、同一份数据，仅在最后按两种形状渲染。

提供该端点的原因是 MiniMax 客户端会自行拼接此地址；不提供的话， 更换 base_url 后会出现提交成功而取回 404 的情况。

新接入建议使用站内统一端点，它附带 usage 与 cost，而 MiniMax 形状中 没有对应字段。本端点也不返回上游的 task_type / modality / usage， 需要用量请使用统一端点。

状态字段

无论是否完成均返回 200，状态在 task.status 中，轮询只需判断该字段。

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

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

Amux 的 expired 状态（任务未能完成、结果不可再取回）映射为 failed： 它是一次有明确原因的失败，不是查询不到。上游的任务记录保留 7 天， 而 Amux 的任务记录不会删除，因此「这个 ID 查不到了」这种情况在本端点不会出现。

轮询节奏

视频生成耗时比图像高一个量级，且主要由排队时间决定，与请求时长不成正比。 建议提交后 20 秒内不查询，之后每 10–15 秒一次——上游给的建议间隔是 10 秒。

不要按输出时长线性估算超时。

产物地址

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

查询不到返回 404

没有该任务、或该任务不属于当前工作区，均返回同一个 404。

两种情况共用同一响应是有意为之：分开返回会使得通过跨工作区试探任务 ID 即可判断其是否存在。

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>"
}