Amux

Retrieve task

最近更新：2026年9月1日

按 ID 查询一个异步生成任务。始终返回 200，轮询时只看 status。

按提交时返回的 ID 查询一个异步生成任务。

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

鉴权

header
Authorizationstring必填

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

请求

idstring必填

提交时返回的任务 ID。

响应

200response

任务的当前状态。终态时带 output。

404response

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

两种情况给同一个响应是有意的：分开的话，拿别的工作区的任务 ID 试一遍

就能确认它存不存在。

轮询怎么写

无论跑没跑完都返 200，状态在 status 里——轮询只判这一个字段就够，不必同时处理两种状态码。

status 到达下面四个之一后不会再变，可以停止轮询：

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

建议间隔 2–5 秒。图像常态 15–120 秒完成。

产物链接会被清理

output.images[].url 为可直接访问的结果地址。产物会定期清理；如需长期保存，请尽快下载。清理后该地址会返回 404。

查不到就是 404

没有这个任务、或者它不属于当前工作区，都返回同样的 404。

这两种情况共用同一个 404 响应，用于避免通过跨工作区试探任务 ID 来确认任务是否存在。

cURL
curl https://gateway.amux.ai/v1/tasks/{id} \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "id": "task_01M1CG35C16CJ790D00BV1RBVM",
  "status": "queued",
  "model": "openai/gpt-image-2",
  "created_at": "<string>",
  "output": {
    "images": [
      {
        "index": 0,
        "url": "<string>"
      }
    ],
    "videos": [
      {
        "index": 0,
        "url": "<string>"
      }
    ]
  },
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "total_tokens": 0,
    "output_video_seconds": 0
  },
  "cost": "0.2108",
  "notes": [
    "dropped audio: this model decides the soundtrack itself"
  ],
  "error": {
    "message": "<string>",
    "code": "<string>"
  }
}