Amux

Retrieve task

最近更新：2026年9月6日

按站内统一形状查 alibaba/happyhorse-1.0 的任务结果，带用量与费用。

按站内统一形状返回 alibaba/happyhorse-1.0 任务的状态与结果。

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

鉴权

header
Authorizationstring必填

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

请求

idstring必填

提交时返回的任务 ID。

响应

200response

任务的当前状态。

404response

没有这个任务，或者它不属于当前工作区。

比百炼形状多两个字段

本端点与百炼形状取回是同一个任务的 两种渲染。本端点附带：

  • usage.output_video_seconds —— 实际出片秒数，cost 就是按它算的；
  • cost —— 本次实际扣费（美元）。

百炼的信封里本来就没有这两个字段，所以那一条给不出。

output.images 恒为空，但字段始终存在

视频任务不产出图像，output.images 一直是空数组。该字段不会消失—— 它为图像任务的存量客户端保留（这些客户端会无条件读取 output.images.length）。 因此不能通过 images 是否存在判断任务模态，那个判断恒为真。 视频产物读 output.videos。

状态与计费

status含义收钱吗
queued / running排队中 / 生成中预扣冻结中
succeeded完成，output.videos 里有产物按实际出片秒数
failed上游拒绝或出错不收，预扣已退
expired任务未能完成，结果也无法再取回不收，预扣已退
canceled被取消不收，预扣已退

建议轮询间隔 15 秒。后四个是终态，不会再变，可以停止轮询。

被摘掉的参数会在这里说明

传了该模型没有的参数（audio / prompt_extend）时，它们会被摘掉， 而日志详情里的**「处理说明」**会逐条写明摘了什么、为什么。

不会因此报错，但也不会静默——摘参数是一件请求侧完全看不出来的事 （请求成功、片子照出，只有那个参数没生效），所以它必须有个地方说。

同一处还会显示上游报的出片实况（真实帧率与比例）。它和你请求里写的 未必一样：ratio 在首帧图生视频时由图片决定，而那正是 「出来的比例怎么不对」最常见的原因。

产物链接会被清理

output.videos[].url 为可直接访问的 mp4 地址。该地址会被定期清理， 需要长期保存请及时下载，清理后返回 404。

错误

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

cURL
curl https://gateway.amux.ai/v1/tasks/{id} \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "id": "task_01M1VD9E8WRYVBR7ES10SNQQQT",
  "status": "queued",
  "model": "alibaba/happyhorse-1.0",
  "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.371307",
  "error": {
    "message": "<string>",
    "code": "<string>"
  }
}