Amux

Retrieve task

最近更新：2026年9月6日

按站内统一形状查 alibaba/wan3.0-video 的任务结果，带用量与费用。

按提交时返回的 ID 查询一个 alibaba/wan3.0-video 的任务。

GEThttps://gateway.amux.ai/v1/tasks/{id}

鉴权

header
Authorizationstring必填

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

请求

idstring必填

提交时返回的任务 ID。

响应

200response

任务的当前状态。succeeded 时附带 output。

404response

没有该任务，或该任务不属于当前工作区。两种情况返回同一响应，以避免通过跨工作区试探任务 ID 判断其是否存在。

状态字段

无论是否完成均返回 200，状态在 status 中，轮询只需判断该字段， 不必同时处理两种状态码。

status 到达下列四个之一后不再变化：

状态含义收钱吗
succeeded完成，output 里有产物按实际出片秒数
failed上游拒绝或出错不收，预扣已退
expired任务未能完成，结果也无法再取回不收，预扣已退
canceled被取消不收，预扣已退

轮询节奏

视频生成耗时比图像高一个量级，且主要由排队时间决定，与请求的时长不成正比：

实测样本端到端耗时
480P / 2 秒约 105 秒
1080P / 30 秒约 891 秒

其中固定开销约 100 秒，因此任何时长的请求都不会在 20 秒内返回结果。 据此设置客户端超时，不要按输出时长线性估算。

建议轮询策略：提交后 20 秒内不查询，之后每 10–15 秒一次。

产物读取 output.videos

产物按类型分组，视频模型的产物在 videos 下。

output.images 字段仍然存在，且恒为空数组。 该字段为图像任务的存量客户端 保留（这些客户端会无条件读取 output.images.length）。因此不能通过 images 是否存在判断模态，该判断恒为真。

产物地址指向 Amux 的存储，不是上游 24 小时过期、带有供应商签名的临时地址。 该地址会被定期清理，需要长期保存请及时下载。

usage 读取 output_video_seconds

视频不产生 token，因此 input_tokens / output_tokens / total_tokens 在视频任务上恒为 0。与 cost 对应的字段是 output_video_seconds：

{
  "status": "succeeded",
  "usage": { "input_tokens": 0, "output_tokens": 0, "total_tokens": 0,
             "output_video_seconds": 5 },
  "cost": "0.825125"
}

上面那个数是 1080P、5 秒的样子。cost 是这次实际扣费（美元）， 失败与过期是 0；当前单价以模型目录里这一页为准。

查不到就是 404

没有这个任务、或者它不属于当前工作区，都返回同样的 404 —— 分开的话，拿别的工作区的任务 ID 试一遍就能确认它存不存在。

cURL
curl https://gateway.amux.ai/v1/tasks/{id} \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "id": "task_01M1CG35C16CJ790D00BV1RBVM",
  "status": "queued",
  "model": "alibaba/wan3.0-video",
  "created_at": "<string>",
  "output": {
    "images": [
      {}
    ],
    "videos": [
      {
        "index": 0,
        "url": "<string>"
      }
    ]
  },
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "total_tokens": 0,
    "output_video_seconds": 0
  },
  "cost": "0.825125",
  "error": {
    "message": "<string>",
    "code": "<string>"
  }
}