Amux

Retrieve video task

最近更新：2026年9月6日

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

按提交时返回的 ID 查询一个视频任务，响应为阿里云百炼（DashScope）的形状。

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

鉴权

header
Authorizationstring必填

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

请求

idstring必填

提交时返回的 Amux 任务 ID。

响应

200response

无论跑没跑完都是 200，状态在 output.task_status 里。

404response

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

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

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

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

新接入建议使用站内统一端点，它附带 usage 与 cost， 而百炼形状中没有对应字段。本端点也不返回上游的 submit_time / scheduled_time / end_time / orig_prompt，需要时间线请使用统一端点。

状态字段

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

task_status含义是否计费
PENDING排队中——
RUNNING生成中——
SUCCEEDED已完成，产物在 output.video_url按实际出片秒数计费
FAILED上游拒绝或出错不计费，预扣已释放
CANCELED已取消不计费，预扣已释放
UNKNOWN状态无法映射到该词汇表——

UNKNOWN 在本端点的含义与上游不同。 上游用它表示任务已不可查询 （其任务记录 24 小时后失效）。Amux 的任务记录不会删除，该情形不会出现， 因此将 UNKNOWN 作为放弃条件的客户端在此不会命中该分支。

同理，Amux 的 expired 状态（任务未能完成、结果不可再取回）映射为 FAILED 而非 UNKNOWN：它是一次有明确原因的失败，不是查询不到。

轮询节奏

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

耗时逐模型不同，下面是各自的实测值，仅供设定客户端超时时参考：

模型实测
wan3.0-video480P/2 秒约 105 秒，1080P/30 秒约 891 秒
happyhorse-1.1480P/3 秒约 65 秒

请据此设置客户端超时，不要按输出时长线性估算。建议提交后 20 秒内不查询， 之后每 10–15 秒一次。上游对这条查询接口给的建议间隔是 15 秒。

产物地址

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

查询不到返回 404

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

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

cURL
curl https://gateway.amux.ai/api/v1/tasks/{id} \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "output": {
    "task_id": "<string>",
    "task_status": "PENDING",
    "video_url": "<string>",
    "code": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}