千问-图像编辑模型支持多图输入和多图输出,可精确修改图内文字、增删或移动物体、改变主体动作、迁移图片风格及增强画面细节。
模型概览
输入图1 | 输入图2 | 输入图3 | 输出图像(多图) | |
|---|---|---|---|---|
![]() | ![]() | ![]() | ![]() | ![]() |
输入提示词:图1中的女生穿着图2中的黑色裙子按图3的姿势坐下。
| 模型名称 | 模型简介 | 输出图像规格 |
|---|---|---|
qwen-image-2.0-pro 推荐当前与qwen-image-2.0-pro-2026-04-22能力相同 | 千问图像生成与编辑模型Pro系列。文字渲染、真实质感、语义遵循能力更强。图像生成请参考千问-文生图。 | 图像分辨率:
|
qwen-image-2.0-pro-2026-06-22 推荐 | ||
| qwen-image-2.0-pro-2026-04-22 | ||
| qwen-image-2.0-pro-2026-03-03 | ||
qwen-image-2.0 推荐当前与qwen-image-2.0-2026-03-03能力相同 | 千问图像生成与编辑模型加速版,兼顾效果与响应速度。图像生成请参考千问-文生图。 | |
qwen-image-2.0-2026-03-03 推荐 | ||
qwen-image-edit-max当前与qwen-image-edit-max-2026-01-16能力相同 | 千问图像编辑Max系列。工业设计、几何推理、角色一致性更强。 | 图像分辨率:
|
| qwen-image-edit-max-2026-01-16 | ||
qwen-image-edit-plus当前与qwen-image-edit-plus-2025-10-30能力相同 | 千问图像编辑Plus系列,支持多图输出与自定义分辨率。 | |
| qwen-image-edit-plus-2025-12-15 | ||
| qwen-image-edit-plus-2025-10-30 | ||
| qwen-image-edit | 支持单图编辑和多图融合。 | 图像分辨率:不可指定。生成规则同上方的默认规则。图像格式:png图像张数:固定1张 |
前提条件
在调用前,您需要获取与配置 API Key,再配置API Key到环境变量。
如需通过SDK进行调用,请安装DashScope SDK。目前,该SDK已支持Python和Java。
请将示例代码中的 DASHSCOPE_API_HOST 替换为获取的 API Host。
HTTP调用
新加坡地域:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
北京地域:POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
调用时请将{WorkspaceId}替换为真实的Workspace ID。
请求参数请求头(Headers)Content-Typestring(必选)请求内容类型。此参数必须设置为application/json。Authorizationstring(必选)请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值:Bearer sk-xxxx。请求体(Request Body)modelstring (必选)模型名称,示例值qwen-image-2.0-pro。input object (必选)输入参数对象,包含以下字段:
属性 messages array (必选)请求内容数组。当前仅支持单轮对话,因此数组内有且只有一个对象,该对象包含role和content两个属性。
属性 role string (必选)消息发送者角色,必须设置为user。contentarray (必选)消息内容,包含1-3张图像,格式为 {"image": "..."};以及单个编辑指令,格式为 {"text": "..."}。
属性 image string (必选)输入图像的 URL 或 Base64 编码数据。支持传入1-3张图像。多图输入时,按照数组顺序定义图像顺序,输出图像的比例以最后一张为准。图像要求:
string(必选)正向提示词用于描述您期望生成的图像内容、风格和构图。支持中英文,qwen-image-2.0系列模型长度上限为 1300 Token,其他模型为 800 Token,超出部分将自动截断。注意:仅支持传入一个text,不传或传入多个将报错。object (可选)控制图像生成的附加参数。
属性 n integer (可选)输出图像的数量,默认值为1。对于qwen-image-2.0系列、qwen-image-edit-max、qwen-image-edit-plus系列模型,可选择输出1-6张图片。对于qwen-image-edit,仅支持输出1张图片。negative_prompt string (可选)反向提示词,用来描述不希望在画面中看到的内容,可以对画面进行限制。支持中英文,长度上限500个字符,每个汉字、字母、数字或符号计为一个字符,超过部分会自动截断。示例值:低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。size string (可选)设置输出图像的分辨率,格式为宽*高,例如"1024*1536"。qwen-image-2.0系列模型:
指定
常见比例推荐分辨率
qwen-image-edit以外的模型。prompt_extend boolean (可选)是否开启提示词智能改写,默认值为 true。开启后,模型会优化正向提示词(text),对描述较简单的提示词效果提升明显。支持模型:除qwen-image-edit以外的模型。watermark boolean (可选)是否在图像右下角添加 "Qwen-Image" 水印。默认值为 false。seed integer (可选)随机数种子,取值范围[0,2147483647]。使用相同的seed参数值可使生成内容保持相对稳定。若不提供,算法将自动使用随机数种子。注意:模型生成过程具有概率性,即使使用相同的seed,也不能保证每次生成结果完全一致。 |
此处以使用 qwen-image-2.0-pro模型输出2张图片为例。 |
响应参数outputobject包含模型生成结果。
属性 choices array结果选项列表。
属性 finish_reason string任务停止原因,自然停止时为stop。message object模型返回的消息。
属性 role string消息的角色,固定为assistant。contentarray消息内容,包含生成的图像信息。
属性 image string生成图像的 URL,格式为PNG。链接有效期为24小时,请及时下载并保存图像。object本次调用的资源使用情况,仅调用成功时返回。
属性 image_count integer生成图像的张数。width integer生成图像的宽度(像素)。height integer生成图像的高度(像素)。string请求唯一标识。可用于请求明细溯源和问题排查。codestring请求失败的错误码。请求成功时不会返回此参数,详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误码。 |
任务数据(如任务状态、图像URL等)仅保留24小时,超时后会被自动清除。请您务必及时保存生成的图像。 |
DashScope SDK调用
SDK 的参数命名与HTTP接口基本一致,参数结构根据语言特性进行封装,完整参数列表请参见千问 API 参考。
Python SDK调用
- 推荐安装最新版DashScope Python SDK,否则可能运行报错:安装或升级SDK。
- 不支持异步接口。
请求示例
响应示例
图像链接的有效期为24小时,请及时下载图像。
input_tokens、output_tokens和characters为兼容字段,当前固定为0。
Java SDK调用
推荐安装最新版DashScope Java SDK,否则可能运行报错:安装或升级SDK。
请求示例
响应示例
图像链接的有效期为24小时,请及时下载图像。
错误码
如果模型调用失败并返回报错信息,请参见错误码进行解决。
计费与限流
- 模型免费额度和计费单价请参见选择模型。
- 模型限流请参见千问(Qwen-Image)。
- 计费说明:按成功生成的 图像张数 计费。模型调用失败或处理错误不产生任何费用,也不消耗新人免费额度。




