Amux

Retrieve image task

最近更新：2026年9月7日

按百炼原生形状查 qwen/qwen-image-3.0-pro 的任务结果。

查询一个 qwen/qwen-image-3.0-pro 的出图任务，响应为阿里云百炼原生形状。 DashScope 客户端会自行拼接该地址，因此更换 base_url 后取回同样可用。

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

鉴权

header
Authorizationstring必填

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

请求

idstring必填

提交时返回的任务 ID。

响应

200response

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

404response

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

它和站内取回口查的是同一个任务

一个任务、两种渲染，不是两套存储。新接入建议用 GET /v1/tasks/{id}—— 它附带 usage 与 cost，而百炼形状里没有对应字段。

与上游的一处行为差异

上游的任务记录 24 小时后失效并返回 UNKNOWN。本站的任务记录不会删除， 始终返回真实终态，因此把 UNKNOWN 当作放弃条件的客户端在此不会命中该分支。

产物地址是我们的

choices[].message.content[].image 指向本站存储，不是上游那个带签名的临时地址。 该地址会被定期清理，需要长期保存请及时下载。

错误

错误体形状与阿里云百炼一致，type 取值与重试语义见错误与重试。

cURL
curl https://gateway.amux.ai/api/v1/tasks/{id} \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "output": {
    "task_id": "task_01M1CG35C16CJ790D00BV1RBVM",
    "task_status": "PENDING",
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            {
              "type": "image",
              "image": "https://cdn.amux.ai/gen/20260907/task_01M1CG35C16CJ790D00BV1RBVM-0.png"
            }
          ]
        }
      }
    ],
    "code": "<string>",
    "message": "<string>"
  },
  "request_id": "task_01M1CG35C16CJ790D00BV1RBVM"
}