Qwen图像编辑API
更新时间 2026-09-06 17:29:36
最近更新时间: 2026-09-06 17:29:36
本文介绍千问图像编辑模型调用API。
支持的模型
| 模型名称 | 模型简介 | 输出规格 |
|---|---|---|
| qwen‑image‑edit | 基础图像编辑模型，支持单图编辑、多图融合，能力基础。 | 输出固定 1 张 PNG；不可指定 size；输出分辨率默认接近 1024*1024，宽高比跟随输入图；不支持prompt_extend、watermark、自定义 size 参数。 |
| qwen‑image‑edit‑max | Max 系列，工业设计、几何推理、角色一致性能力更强。 | PNG 格式；输出张数 1‑6 张；宽高可自定义，取值范围 512‑2048px；默认总像素接近 1024*1024，宽高比取最后一张输入图比例。 |
| qwen‑image‑edit‑plus | Plus 系列，支持多图输入、多图输出、自定义分辨率，综合编辑能力均衡。 | PNG 格式；输出张数 1‑6 张；宽高可自定义，取值范围 512‑2048px；默认总像素接近 1024*1024，宽高比取最后一张输入图比例。 |
接口详情
http调用
请求方式：POST
请求路径：https://ai.ctaigw.cn/v1/services/aigc/multimodal-generation/generation
说明
归属中国大陆区域的模型，HTTP 请求地址： https://ai.ctaigw.cn/v1/services/aigc/multimodal-generation/generation
归属全球区域的模型，根据算力所属区域，HTTP请求地址存在差异，具体模型的请求地址详见控制台-模型广场-模型详情页-调用示例。
美洲： https://ai.ctaigw.com/us/v1/services/aigc/multimodal-generation/generation，欧洲：https://ai.ctaigw.com/eu/v1/services/aigc/multimodal-generation/generation，亚洲：https://ai.ctaigw.com/as/v1/services/aigc/multimodal-generation/generation
请求头
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Content‑Type | string | 是 | 固定application/json |
| Authorization | string | 是 | Bearer ${YOUR_APP_KEY} |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型调用名称或模型id |
| input | object | 是 | 输入对象 |
| input.messages | array | 是 | 仅支持单轮对话，数组只有 1 个对象 |
| input.messages[0].role | string | 是 | 固定为user |
| input.messages[0].content | array | 是 | 内容数组，包含 1‑3 个{"image":"xxx"} + 1 个 |
| content[].image | string | 是 | 图片地址：公网 http/https、oss 临时 url、base64 字符串 |
| content[].text | string | 是 | 图像编辑提示词； max/plus 上限 800token； qwen‑image‑edit 同样 800token； 仅允许 1 个 text 对象，多个会报错 |
| parameters | object | 否 | 生成控制参数 |
| parameters.n | int | 否 | 输出图片数量； max/plus：1‑6； qwen‑image‑edit仅支持 n=1；默认 1 |
| parameters.negative_prompt | string | 否 | 反向提示词，最大 500 字符，超出自动截断 |
| parameters.size | string | 否 | 输出分辨率，格式宽*高； qwen‑image‑edit 不支持该参数； max/plus 宽高必须 512‑2048； 实际输出会对齐 16 的倍数 |
| parameters.prompt_extend | boolean | 否 | 是否开启提示词智能改写； qwen‑image‑edit 不支持； |
| parameters.watermark | boolean | 否 | 右下角是否添加 Qwen‑Image 水印； qwen‑image‑edit 不支持； |
| parameters.seed | integer | 否 | 随机种子，取值 0‑2147483647； 相同 seed 也不能保证结果完全一致 |
响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
| output | object | 输出结果对象 |
| output.choices | array | 结果列表 |
| choices[0].finish_reason | string | 任务结束原因，正常完成返回stop |
| choices[0].message | object | 返回消息 |
| message.role | string | 固定assistant |
| message.content | array | 生成图片数组 |
| usage | object | 资源消耗 |
| usage.image_count | int | 生成图片张数 |
| usage.width / height | int | 输出图像像素宽高 |
| request_id | string | 请求唯一 ID，用于排查问题 |
请求/响应示例
请求示例
curl --location 'https://ai.ctaigw.cn/v1/services/aigc/multimodal-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer ${YOUR_APP_KEY}" \
--data '{
"model": "qwen-image-2.0-pro",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"image": "https://aaaa.ctyun.cn/pic/3.jpg"
},
{
"text": "把图片中的红色花朵修改为蓝色花朵，其他画面保持不变。"
}
]
}
]
},
"parameters": {
"n": 1,
"size": "2048*2048"
}
}'成功响应示例
{
"output": {
"choices": [
{
"finish_reason": "stop",
"message": {
"content": [
{
"image": "https://aaaa.ctyun.cn/pic/3.jpg"
}
],
"role": "assistant"
}
}
]
},
"usage": {
"height": 2048,
"image_count": 1,
"width": 2048
},
"request_id": "00d06a841873c0a83bfaf1fae0184625"
}异常响应示例
{
"error": {
"type:": "Invalid_request",
"code": "missing_parameter",
"message": "Missing required parameters"
}
}
