Aliyun Qwen-Image 文生图

Qwen-Image / Plus / 2.0 / Max / Edit 系列文生图, 同步返回 OSS URL (24h 有效)

POST /v1/images/generations

## Aliyun Qwen-Image 文生图通义千问图像生成系列, 适用于以下模型: | 模型 | 说明 | |---|---| | `qwen-image` | 基础款, 卓越文本渲染能力, 适合海报 / 对联 / 字体设计 | | `qwen-image-plus` | 旗舰款, 高质量人像 / 场景, 速度较 qwen-image 略慢 | | `qwen-image-plus-2026-01-09` | qwen-image-plus 2026-01-09 快照版 (稳定回滚锚点) | ### 字段命名风格 - `input.prompt` 字符串 — 文本提示词 - `parameters.size` 字符串 — 用 `*` 分隔宽高 (DashScope 风格), 例如 `"1024*1024"` / `"1664*928"` - `parameters.n` 整数 — 生成张数, 当前限 1 张 ### 响应解析 - `output.task_status` — `"SUCCEEDED"` 表示成功 - `output.results[].url` — 图片 URL (临时链接, ~24h 过期, 请及时下载) - `usage.image_count` — 实际生成张数 ### 模型编辑能力如需**图像编辑** (传入参考图改写), 请用 `qwen-image-edit*` 系列, 参见 [Aliyun Qwen-Image Multimodal](/docs/api/aliyun-qwen-image-multimodal) 文档.

Request body

`model`	string	required	Qwen-Image 文生图异步模型. `qwen-image` 基础款 / `qwen-image-plus` 旗舰款 / `-2026-01-09` 是稳定快照
`input`	object	required	输入对象, 包含文本提示词
`prompt`	string	required	文本提示词, 支持中英文混合. 详细描述能显著提升生成质量
`parameters`	object		生成参数
`size`	string		图像尺寸, 用 `*` 分隔宽高 (DashScope 风格). 支持 16:9 / 5:4 / 1:1 / 4:5 / 9:16 等比例
`n`	integer		生成张数, 当前上游限单次 1 张. 需多张请多次调用

Responses

200 — 生成成功, 返回图片 URL
400 — 参数错误, 例如 prompt 为空 / size 取值不支持 / model 名不识别等
429 — 请求频次或并发超限, 等待或降低 QPS 后重试

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-plus",
    "input": {
      "prompt": "一只穿着宇航服的橘猫站在月球上, 背景星空, 写实风格"
    },
    "parameters": {
      "size": "1024*1024",
      "n": 1
    }
  }'

API reference