Amux

Retrieve video task

最近更新：2026年9月6日

按百炼原生形状查 alibaba/happyhorse-1.0 的任务结果。

按阿里云百炼原生形状返回 alibaba/happyhorse-1.0 任务的状态与结果。

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

鉴权

header
Authorizationstring必填

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

请求

idstring必填

提交时返回的任务 ID（我们的 ID，不是上游 ID）。

响应

200response

任务的当前状态。

404response

没有这个任务，或者它不属于当前工作区。两种情况同样返回 404：

用 403 会让人确认一个任务是否存在。

与站内统一取回是同一个任务

本端点与站内统一取回返回的是 同一个任务的两种渲染，不是两套任务系统。

挂这条地址是因为 DashScope SDK 会自行拼接它——不挂的话，用户改一个 base_url 之后提交成功、取回 404。若不需要兼容既有 SDK，建议用站内统一取回：那一条附带 usage 与 cost，而百炼的信封里本来就没有这两个字段。

只认我们的任务 ID

task_id 是 Amux 的 ID。上游那个 ID 是内部字段，不会出现在任何响应里。

状态与计费

task_status含义收钱吗
PENDING / RUNNING排队中 / 生成中预扣冻结中
SUCCEEDED完成，video_url 可用按实际出片秒数
FAILED上游拒绝或出错不收，预扣已退
CANCELED被取消不收，预扣已退
UNKNOWN我们没能把状态映到这套词汇上见下

UNKNOWN 在上游表示「这个任务我忘了」（它的任务 24 小时后就这么答）。 在本站不会出现——任务行永不删，我们永远答得出终态。

建议轮询间隔 15 秒。该模型的常态耗时是分钟级，更密的轮询不会更快拿到结果。

产物链接会被清理

video_url 指向我们的存储，不是上游那个 24 小时过期、带供应商签名的临时地址。 该地址会被定期清理，需要长期保存请及时下载，清理后返回 404。

错误

type 取值与重试语义见错误与重试。

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