Amux

Retrieve video task

最近更新：2026年9月6日

按百炼原生形状查 alibaba/wan3.0-video-prime 的任务结果。

查询一个 alibaba/wan3.0-video-prime 的视频任务，响应为阿里云百炼原生形状。 DashScope 客户端会自行拼接该地址，因此更换 base_url 后取回同样可用。

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

鉴权

header
Authorizationstring必填

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

请求

idstring必填

提交时返回的任务 ID。

响应

200response

无论是否完成均返回 200，状态在 output.task_status 中。

404response

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

状态字段

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

task_status含义收钱吗
PENDING排队中——
RUNNING生成中——
SUCCEEDED完成，output.video_url 里是产物按实际出片秒数
FAILED上游拒绝、出错，或任务未能完成不收，预扣已退
CANCELED被取消不收，预扣已退
UNKNOWN我们没能把自己的状态映到这套词汇上——

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

轮询节奏

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

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

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

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

产物地址

output.video_url 指向 Amux 的存储。上游返回的是 24 小时过期、带有供应商签名的 临时地址，Amux 会先将视频转存再对外提供。

该地址同样会被定期清理，需要长期保存请及时下载，清理后返回 404。

本形状未包含的字段

两类，均可从站内统一端点获取：

  1. 用量与费用：百炼形状中没有承载它们的字段；
  2. 时间线与原始提示词：上游另会返回 submit_time / scheduled_time / end_time / orig_prompt，本端点不返回。本端点仅映射客户端实际读取的 字段，逐字段重建而非原样透传。

查不到就是 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>"
}