Aliyun Qwen-Image (多模态图像生成 / 编辑)

POST /v1/images/generations

## Aliyun Qwen-Image Multimodal (多模态图像生成 / 编辑) 通义千问图像生成多模态接口. 适用模型: | 模型 | 类型 | 说明 | |---|---|---| | `qwen-image-2.0` | 文生图 | 2.0 基础款 | | `qwen-image-2.0-pro` | 文生图 | 2.0 高质量增强版 | | `qwen-image-max` | 文生图 | 旗舰高质量 | | `qwen-image-edit` | 图像编辑 | 必须传 1-3 张参考图 | | `qwen-image-edit-plus` | 图像编辑 | 编辑增强版 | | `qwen-image-edit-max` | 图像编辑 | 编辑旗舰版 | ### Body 结构 - `input.messages[]` 数组 — 一个 user message 含多个 content blocks - 每个 `content[]` block: - `{"text": "提示词"}` — 文本提示 - `{"image": "https://..."}` — 参考图 URL, 必须公网可达 (https) ### 模型协议要求 | 模型 | content 必须包含 | 备注 | |---|---|---| | qwen-image-2.0 / -2.0-pro / -max | 1 个 `{text}` | 纯文生图, 可选 0 个 `{image}` | | qwen-image-edit / -edit-plus / -edit-max | 1 个 `{text}` + **1-3 个 `{image}`** | 必须传参考图 | ### 响应解析 - `output.choices[0].message.content[]` — 数组, 含 1 个 `{"image": "https://..."}` 块 - `usage.image_count` / `usage.height` / `usage.width` — 生成图片信息 ### 基础文生图 (无参考图) 如只需简单文生图 (不需多模态), 也可用更轻量的 [Aliyun Qwen-Image 文生图](/docs/api/aliyun-qwen-image) 接口 (qwen-image / qwen-image-plus).

Request body

`model`	string	required	Qwen-Image multimodal 模型. `-2.0` / `-2.0-pro` / `-max` 文生图; `-edit*` 系列需 1-3 张参考图编辑
`input`	object	required	输入对象, 包含 messages 数组
`messages`	array	required	对话消息数组. 当前 image 场景仅支持单个 user message
`role`	string	required	消息角色, 当前仅 user
`content`	array	required	内容块数组. 必须含至少 1 个 `{text}`. 编辑类模型必须再含 1-3 个 `{image}` 参考图
`text`	string		文本提示词 (单 content block 内仅 `text` 或 `image` 二选一)
`image`	string		参考图 URL (https), Aliyun 上游内部下载. URL 必须公网可达
`parameters`	object		生成参数
`size`	string		图像尺寸, DashScope 风格 (`*` 分隔)
`n`	integer		生成张数, 当前上游限单次 1 张
`seed`	integer		随机种子. 同 prompt + 同 seed 可复现近似结果, 便于风格调优
`watermark`	boolean		是否添加水印
`negative_prompt`	string		负向提示词 — 模型应避免的元素
`prompt_extend`	boolean		是否启用 prompt 智能扩展 (上游自动补充细节)

Responses

200 — 生成成功, 返回图片 URL
400 — 参数错误, 编辑类模型未传参考图 / model 名不识别 / size 不支持等
429 — 请求频次或并发超限

Example

curl -X POST "https://api.router.ai/v1/images/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-edit",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            {"text": "把这张图改成赛博朋克风格, 加上霓虹灯"},
            {"image": "https://example.com/reference.png"}
          ]
        }
      ]
    },
    "parameters": {
      "size": "1024*1024",
      "n": 1,
      "seed": 42
    }
  }'

API reference