Amux

Create image task

最近更新：2026年9月7日

按百炼原生形状提交异步出图任务，立刻拿 task_id。取回口和视频那条是同一条。

和同步那条收同样的请求体， 但立刻返回 task_id，出图在后台进行。

POSThttps://gateway.amux.ai/api/v1/services/aigc/image-generation/generation

鉴权

header
Authorizationstring必填

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

请求

application/json
modelstring必填

站内模型 ID。今天这条端点上有 alibaba/qwen-image-3.0 与 alibaba/qwen-image-3.0-pro。

inputobject必填

对话形状的输入。提示词与参考图都在这里，不是分开的两个字段。

›inputobject
messagesarray<object>

一条 user 消息即可。

›messagesarray<object>
rolestring

固定 user。

contentarray<object>

提示词与参考图的混合数组。至少要有一项 text。

›contentarray<object>
textstring

提示词。多项会按顺序换行拼接。

imagestring

参考图：公开 https 地址，或 data:image/…;base64,…。最多 3 张。

parametersobject

生成参数，均为可选。

›parametersobject
sizestring

宽*高。面积必须在 262144（512×512）与 6553600（2560×2560）之间，宽高比 1:8 到 8:1。⚠️ 1024x1024 这种 x 写法也收，发给上游前会归一。

ninteger默认 1

出图张数，1–6。

seedinteger

随机种子，0–2147483647。

negative_promptstring

反向提示词：不希望出现在画面里的内容。

prompt_extendboolean

是否让模型先把提示词改写扩写一遍。上游默认开。

watermarkboolean默认 false

是否在输出图上添加水印。

webhook_urlstring

任务到终态时往这里 POST 一份结果。⚠️ 这个字段是本站加的，官方没有（百炼的回调只能在控制台配 EventBridge）。形状与 POST /v1/tasks 的回调完全一致。

响应

200response

任务已受理。拿 output.task_id 去 GET /api/v1/tasks/{id} 轮询。

400response

参数不合法：尺寸面积或宽高比越界、参考图超过 3 张、缺提示词。

402response

可用余额不足以覆盖预扣上界。

503response

当前没有可用的供应商能服务这个模型。

支持的模型

与同步那条完全一致：

模型专属文档
qwen/qwen-image-3.0Qwen-Image 3.0
qwen/qwen-image-3.0-proQwen-Image 3.0 Pro

三处照着官方来的地方

  • 返回 200 而不是 202。 阿里云百炼官方那条就是 200，按官方形状实现的 客户端会把 202 判成失败；
  • X-DashScope-Async: enable 收下即忽略。 这条路径在本站恒为异步， 带不带都一样；
  • 取回走 GET /api/v1/tasks/{id} ——和视频那条是同一条端点，按任务的模态渲染成两种形状，不是两条地址。

⚠️ 参数校验仍然在提交这一刻做完

上游那条异步端点不校验入参：size 写错了也照收，十几秒后任务才失败。 本站在建任务之前就会拒，错误里说得清是哪个参数、可接受的范围是什么。

这是一处本站更严格的差异，而它省下的正是「等十几秒才知道自己写错了一个字符」。

一处官方没有的地方

webhook_url 是本站加的。百炼的异步任务确实有回调，但它是在阿里云控制台 用 EventBridge 配事件规则，请求里传不了地址。不加的话，走这条端点的调用方 只能轮询，而同一个任务走站内统一入口就能收到推送。

写在顶层（与 input / parameters 平级）或写进 parameters 里都收； 两处都写且不一样时报错，不替你挑一个。

只收 https，且不能指向内网——我们是从服务端发过去的。地址在提交这一刻 就校验，写错了当场报错，而不是等任务跑完才发现回调从来没来。

取回方式

task_id 是 Amux 的任务 ID，不是上游 ID。两条取回端点都接受它， 返回的是同一个任务的两种渲染：

取回端点响应形状适用场景
GET /api/v1/tasks/{id}百炼原生百炼客户端会自行拼接该地址
GET /v1/tasks/{id}站内统一新接入建议使用，附带 usage 与 cost

百炼形状中没有承载用量与费用的字段，因此这两项只在站内统一端点上提供。

错误

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

cURL
curl https://gateway.amux.ai/api/v1/services/aigc/image-generation/generation \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "alibaba/qwen-image-3.0",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "text": "A red paper boat drifting down a rain gutter"
            }
          ]
        }
      ]
    },
    "parameters": {
      "size": "1024*1024"
    }
  }'
{
  "output": {
    "task_id": "<string>",
    "task_status": "<string>"
  },
  "request_id": "<string>"
}