⌘K

Qwen Image Edit Plus

qwen_image_edit_plus

该图像编辑模型支持多图输入和输出. 可精准修改图中文字, 支持添加、删除或移动物体, 改变主体动作, 实现图像风格迁移, 并增强画面细节

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

访问 API Key 管理页面 获取 API Key

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID

值: qwen_image_edit_plus

input object 必填

输入参数对象, 包含以下字段

messages array 必填

请求内容数组. 当前仅支持单轮对话, 因此数组内有且只有一个对象, 该对象包含 role 和 content 两个属性

role string 必填

消息发送者角色

值: user

content array 必填

消息内容, 包含 1 - 3 张图像（格式 {"image":"..."}）以及单个编辑指令（格式 {"text":"..."}）

image string 必填

输入图像的 URL 或 Base64 编码数据, 支持传入 1 - 3 张图像

多图输入时, 按照数组顺序定义图像顺序, 输出图像的比例以最后一张为准
图像格式支持: JPG、JPEG、PNG、BMP、TIFF、WEBP 和 GIF
输出图像为 PNG 格式, 对于 GIF 动图仅处理第一帧
图像分辨率建议: 宽和高均在 384 像素至 3072 像素之间. 分辨率过低可能导致生成模糊, 过高会增加处理时长
图像大小不超过 10MB
支持输入格式包括公网 URL 和 Base64 字符串
公网 URL 支持 HTTP 和 HTTPS 协议
URL 示例: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp
Base64 示例: data:image/jpeg;base64,GDU7MtCZz...

text string 必填

正向提示词, 用于描述期望生成的图像内容、风格和构图
支持中英文, 长度不超过 800 个字符, 每个汉字、字母、数字或符号计为一个字符, 超过部分会自动截断
示例: 图1中的女生穿着图2中的黑色裙子按图3的姿势坐下, 保持其服装、发型和表情不变, 动作自然流畅
仅支持传入一个 text, 不传或传入多个将报错

parameters object

控制图像生成的附加参数

n integer

输出图像数量

支持输出 1 - 6 张图像

默认值: 1

negative_prompt string

反向提示词, 用于描述不希望在画面中出现的内容
支持中英文, 长度上限 500 个字符, 每个汉字、字母、数字或符号计为一个字符, 超过部分会自动截断
示例: 低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等

size string

设置输出图像分辨率, 格式为 宽*高, 例如 1024*1536. 宽和高取值范围均为 512 - 2048 像素
常见比例推荐分辨率:
1:1: 1024*1024、1536*1536
2:3: 768*1152、1024*1536
3:2: 1152*768、1536*1024
3:4: 960*1280、1080*1440
4:3: 1280*960、1440*1080
9:16: 720*1280、1080*1920
16:9: 1280*720、1920*1080
21:9: 1344*576、2048*872
输出图像尺寸规则: 指定 size 时, 系统会以 size 指定宽高为目标, 将实际输出图像宽高调整为最接近的 16 的倍数. 例如设置 1033*1032, 输出图像尺寸为 1040*1024
若不设置 size, 输出图像将保持与输入图像（多图输入时为最后一张）相似的宽高比, 总像素数接近 1024*1024

prompt_extend boolean

是否开启提示词智能改写

开启后, 模型会优化正向提示词（text）, 对描述较简单的提示词效果提升明显
默认值: true

watermark boolean

是否在图像右下角添加 Qwen-Image 水印

默认值: false

seed integer

随机数种子

范围: 0 - 2147483647
使用相同 seed 参数值可使生成内容保持相对稳定. 若不提供, 算法将自动使用随机数种子
模型生成过程具有概率性, 即使使用相同 seed, 也不能保证每次结果完全一致

轮询

由于结果生成需要时间，您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

响应格式

error object

错误信息. 仅在 status 为 failed 时出现

code integer

错误码

error_message string

详细错误信息

output array

生成结果. 仅在 status 为 completed 时出现

content array

生成内容列表

type string

资源类型

值: image

url string

生成图像 URL

usage object

使用统计信息. 仅在 status 为 completed 时出现

metadata object

元数据信息