千问-图像编辑模型支持多图输入和多图输出,可精确修改图内文字、增删或移动物体、改变主体动作、迁移图片风格及增强画面细节。
模型概览
提示词 | 输入图 | 输出图像 |
|---|---|---|
在画面右下角石板路旁、靠近树干根部的位置,以浅灰墨色手写体题写一首七言绝句,字体为行楷风格,笔触自然流畅、略带飞白,大小适中(约占画面高度1/10),与整体水墨淡雅氛围协调。诗文内容为:“青石桥畔柳风轻, 素手拈花闭目听。 一水碧痕浮旧梦, 半篙烟雨入空舲。”诗句横向排列,四句分两行书写(前两句一行,后两句一行),末句“舲”字右下角钤一枚朱红小印,印文为“江南”二字篆书,尺寸约等于单字高度的1/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}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
新加坡地域:POST https://{WorkspaceId}.ap-southeast-1.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,也不能保证每次生成结果完全一致。 |
响应参数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)。
- 计费说明:按成功生成的 图像张数 计费。模型调用失败或处理错误不产生任何费用,也不消耗新人免费额度。
常见问题
Q:千问图像编辑模型支持哪些语言?
A:目前正式支持简体中文和英文;其他语言可自行尝试,但效果存在不确定性。
Q: 如何查看模型调用量?
A: 模型调用完一小时后,请在模型监控(北京)或模型监控(新加坡) 页面,查看模型的调用次数、成功率等指标。详情请参见账单查询与成本管理。Q:如何获取图像存储的访问域名白名单?
A: 模型生成的图像存储于阿里云OSS,API将返回一个临时的公网URL(链接有效期为 24 小时,请及时下载保存)。图片URL的域名格式为dashscope-{标识}.oss-accelerate.aliyuncs.com或dashscope-{标识}.oss-cn-{地域}.aliyuncs.com。若需要对该下载地址进行防火墙白名单配置,请注意:由于底层存储会动态变更,以下bucket名称仅供参考,可能随时更新:dashscope-a717、dashscope-66f3、dashscope-7c2c、dashscope-2522、dashscope-c72b、dashscope-0484、dashscope-7e0f、dashscope-5859、dashscope-5496、dashscope-35f9、dashscope-31d9、dashscope-7f1f、dashscope-cc75、dashscope-64e9。为避免过期信息影响访问,文档不提供固定的OSS域名白名单。如有安全管控需求,请联系客户经理获取最新OSS域名列表。API当前仅支持返回URL格式,不支持base64格式输出。


