Create image

这个端点兼容阿里云百炼（DashScope）的多模态生成接口。已有百炼代码时， 将 base_url 指向本站即可，请求体与响应形状与客户端现有的一致。

提示词与参考图都在 input.messages[].content[] 里——它是多模态对话的消息形状， 出图复用了它。

鉴权

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

出图完成。产物地址指向本站存储，不是上游那个会过期的临时地址。

400response

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

402response

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

503response

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

支持的模型#

这条端点上今天有两个模型：

两者收的参数逐字段相同，差别只在画质与计价：3.0 的输出不分档， Pro 的输出按 1K / 2K 分两档。具体单价见各自的模型详情页—— 价格会调整，写在这里迟早和实际收费漂开。

只调用一个模型时，请直接看它的专属文档——那里的每一项都是它真正收的。

该端点是同步的#

连接挂着，直接回图，实测 35–70 秒。这不是本站的开销，上游的同步端点本来 就是这个量级。

同步链路上任何一环超时（反向代理、网关、客户端默认值）都会让你拿不到图， 而钱已经花了——上游那一侧已经跑完并收了我们的钱。不想守着连接的话有两条路：

生成与图生图是同一条调用#

content[] 里不带 {"image": "…"} 就是生成，带了就是图生图，参数是同一套。 参考图最多 3 张，收公开 https 地址，也收 data:image/png;base64,... 形式的内联图。

计费按张#

按张计价，不按 token——这条端点上三个 token 字段恒为 0。 输入图（参考图）与输出图各自按张计，提示词不计价。

Pro 的输出图按 1K / 2K 分档，档位由上游按像素面积算并在 usage 里报回来。 提交时按上界预扣，完成后按上游报的实际档结算并退还差额。

与官方接口的两处差异#

1. 产物地址不会失效得那么快。 官方返回的是带签名的临时地址， 本站会先把图转存至自有存储。该地址同样会被定期清理， 需要长期保存请及时下载；
2. 参数在提交这一刻就校验。 size 的面积区间（262,144–6,553,600） 与宽高比（1:8–8:1）超出时当场 400，并写明可接受的范围， 不会被静默替换成一个我们猜的尺寸。

错误#

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

curl https://gateway.amux.ai/api/v1/services/aigc/multimodal-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": {
    "choices": [
      {
        "finish_reason": "<string>",
        "message": {
          "role": "<string>",
          "content": [
            {
              "type": "<string>",
              "image": "<string>"
            }
          ]
        }
      }
    ]
  },
  "request_id": "<string>"
}