Skip to main content
千问-早期图像模型

千问-图像编辑API参考

千问-图像编辑模型支持多图输入和多图输出,可精确修改图内文字、增删或移动物体、改变主体动作、迁移图片风格及增强画面细节。

快速入口:使用指南 | 技术博客 | 在线体验

模型概览

提示词

输入图

输出图像

在画面右下角石板路旁、靠近树干根部的位置,以浅灰墨色手写体题写一首七言绝句,字体为行楷风格,笔触自然流畅、略带飞白,大小适中(约占画面高度1/10),与整体水墨淡雅氛围协调。诗文内容为:“青石桥畔柳风轻, 素手拈花闭目听。 一水碧痕浮旧梦, 半篙烟雨入空舲。”诗句横向排列,四句分两行书写(前两句一行,后两句一行),末句“舲”字右下角钤一枚朱红小印,印文为“江南”二字篆书,尺寸约等于单字高度的1/3。

image (18)-2026-03-10-16-39-59

image (19)

使用图一的城市照片作为底图。请勿更改照片中的真实建筑、街道、车辆或人物。保持照片的真实性。三个图二中的卡通形象在建筑物周围,一个趴在建筑物上方,一个从建筑物的右边探出头来,一个坐在建筑物前的空地上。该形象应采用扁平化的图形风格绘制,轮廓清晰,类似于壁画或海报插图。

image (15)-combine

image (17)

模型名称模型简介输出图像规格
qwen-image-2.0-pro 推荐
当前与qwen-image-2.0-pro-2026-04-22能力相同
千问图像生成与编辑模型Pro系列。文字渲染、真实质感、语义遵循能力更强。
图像生成请参考千问-文生图
图像分辨率:
  • 可指定:图像总像素需在512512至20482048之间。
  • 默认:总像素数接近 1024*1024,宽高比与输入图(多图输入时为最后一张)相近。
图像格式:png图像张数:1-6张
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系列。工业设计、几何推理、角色一致性更强。图像分辨率:
  • 可指定:宽和高的取值范围均为[512, 2048]像素。
  • 默认:总像素数接近 1024*1024,宽高比与输入图(多图输入时为最后一张)相近。
图像格式:png图像张数:1-6张
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。
华北2(北京)和新加坡地域拥有独立的 API Key请求地址,不可混用,跨地域调用将导致鉴权失败或服务报错。
阿里云百炼为华北2(北京)、新加坡地域推出了业务空间专属域名,能够为推理请求提供卓越的性能和更高的稳定性,建议迁移至新域名:
  • 华北2(北京)地域:从 https://dashscope.aliyuncs.com 迁移至 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • 新加坡地域:从 https://dashscope-intl.aliyuncs.com 迁移至 https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
其中 {WorkspaceId} 为您的业务空间 ID,可在阿里云百炼控制台的业务空间详情页面查看。现有域名仍可正常使用。

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/jsonAuthorizationstring(必选)请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值:Bearer sk-xxxx。
请求体(Request Body)
model string (必选)模型名称,示例值qwen-image-2.0-pro。input object (必选)输入参数对象,包含以下字段:

属性

messages array (必选)请求内容数组。当前仅支持单轮对话,因此数组内有且只有一个对象,该对象包含rolecontent两个属性。

属性

rolestring (必选)消息发送者角色,必须设置为usercontentarray (必选)消息内容,包含1-3张图像,格式为 {"image": "..."};以及单个编辑指令,格式为 {"text": "..."}

属性

image string (必选)输入图像的 URL 或 Base64 编码数据。支持传入1-3张图像。多图输入时,按照数组顺序定义图像顺序,输出图像的比例以最后一张为准。图像要求:
  • 图像格式:JPG、JPEG、PNG、BMP、TIFF、WEBP和GIF。
    输出图像为PNG格式,对于GIF动图,仅处理其第一帧。
  • 图像分辨率:为获得最佳效果,建议图像的宽和高均在384像素至3072像素之间。分辨率过低可能导致生成效果模糊,过高则会增加处理时长。
  • 图像大小:不超过10MB。
支持的输入格式
  1. 公网URL:
    • 支持 HTTP 和 HTTPS 协议。
    • 示例值:https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp
  2. 临时URL:
  3. 传入 Base64 编码图像后的字符串
textstring(必选)正向提示词用于描述您期望生成的图像内容、风格和构图。支持中英文,qwen-image-2.0系列模型长度上限为 1300 Token,其他模型为 800 Token,超出部分将自动截断。注意:仅支持传入一个text,不传或传入多个将报错。
parameters 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系列模型
  • 图像总像素需在512512至20482048之间。
  • 默认总像素数接近 1024*1024,宽高比与输入图(多图输入时为最后一张)相近。
qwen-image-edit-max、qwen-image-edit-plus系列模型
  • 宽和高的取值范围均为[512, 2048]像素。
  • 默认总像素数接近 1024*1024,宽高比与输入图(多图输入时为最后一张)相近。
指定 size 参数,系统会以 size指定的宽高为目标,将实际输出图像的宽高调整为最接近的16的倍数。例如,设置1033*1032,输出图像尺寸为1040*1024

常见比例推荐分辨率

  • 1:1: 10241024、15361536
  • 2:3: 7681152、10241536
  • 3:2: 1152768、15361024
  • 3:4: 9601280、10801440
  • 4:3: 1280960、14401080
  • 9:16: 7201280、10801920
  • 16:9: 1280720、19201080
  • 21:9: 1344576、2048872
支持模型:除qwen-image-edit以外的模型。prompt_extend boolean (可选)是否开启提示词智能改写,默认值为 true。开启后,模型会优化正向提示词(text),对描述较简单的提示词效果提升明显。支持模型:除qwen-image-edit以外的模型。watermark boolean (可选)是否在图像右下角添加 "Qwen-Image" 水印。默认值为 falseseed integer (可选)随机数种子,取值范围[0,2147483647]使用相同的seed参数值可使生成内容保持相对稳定。若不提供,算法将自动使用随机数种子。注意:模型生成过程具有概率性,即使使用相同的seed,也不能保证每次生成结果完全一致。
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
    "model": "qwen-image-2.0-pro",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260310/jiydyi/image+%2818%29-2026-03-10-16-39-59.webp"
                    },
                    {
                        "text": "在画面右下角石板路旁、靠近树干根部的位置,以浅灰墨色手写体题写一首七言绝句,字体为行楷风格,笔触自然流畅、略带飞白,大小适中(约占画面高度1/10),与整体水墨淡雅氛围协调。诗文内容为:“青石桥畔柳风轻, 素手拈花闭目听。 一水碧痕浮旧梦, 半篙烟雨入空舲。”诗句横向排列,四句分两行书写(前两句一行,后两句一行),末句“舲”字右下角钤一枚朱红小印,印文为“江南”二字篆书,尺寸约等于单字高度的1/3。"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "n": 1,
        "negative_prompt": " ",
        "prompt_extend": true,
        "watermark": false,
        "size": "2048*2048"
    }
}'

响应参数

output object包含模型生成结果。

属性

choices array结果选项列表。

属性

finish_reason string任务停止原因,自然停止时为stopmessage object模型返回的消息。

属性

rolestring消息的角色,固定为assistantcontentarray消息内容,包含生成的图像信息。

属性

image string生成图像的 URL,格式为PNG。链接有效期为24小时,请及时下载并保存图像。
usage object本次调用的资源使用情况,仅调用成功时返回。

属性

image_count integer生成图像的张数。width integer生成图像的宽度(像素)。height integer生成图像的高度(像素)。
request_idstring请求唯一标识。可用于请求明细溯源和问题排查。codestring请求失败的错误码。请求成功时不会返回此参数,详情请参见错误码messagestring请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误码
  • 任务执行成功
  • 任务执行异常
任务数据(如任务状态、图像URL等)仅保留24小时,超时后会被自动清除。请您务必及时保存生成的图像。
{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "content": [
                        {
                            "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ],
                    "role": "assistant"
                }
            }
        ]
    },
    "usage": {
        "height": 2048,
        "image_count": 1,
        "width": 2048
    },
    "request_id": "571ae02f-5c9d-436c-83c2-f221e6df0xxx"
}

DashScope SDK调用

SDK 的参数命名与HTTP接口基本一致,参数结构根据语言特性进行封装,完整参数列表请参见千问 API 参考

Python SDK调用

  • 推荐安装最新版DashScope Python SDK,否则可能运行报错:安装或升级SDK
  • 不支持异步接口。

请求示例

import json
import os
from dashscope import MultiModalConversation
import dashscope

# 以下为华北2(北京)地域的URL。请将 {WorkspaceId} 替换为您的百炼业务空间ID,各地域的URL不同。
dashscope.base_http_api_url = 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1'

# 模型支持输入1-3张图片
messages = [
    {
        "role": "user",
        "content": [
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260310/rdsgaa/image+%2815%29.png"},
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260310/qokhtl/image+%2816%29.png"},
            {"text": "使用图一的城市照片作为底图。请勿更改照片中的真实建筑、街道、车辆或人物。保持照片的真实性。三个图二中的卡通形象在建筑物周围,一个趴在建筑物上方,一个从建筑物的右边探出头来,一个坐在建筑物前的空地上。该形象应采用扁平化的图形风格绘制,轮廓清晰,类似于壁画或海报插图。"}
        ]
    }
]

# 新加坡和北京地域的API Key不同。获取API Key:https://help.aliyun.com/zh/model-studio/get-api-key
# 若没有配置环境变量,请用百炼 API Key 将下行替换为:api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

# qwen-image-2.0系列、qwen-image-edit-max、qwen-image-edit-plus系列支持输出1-6张图片
response = MultiModalConversation.call(
    api_key=api_key,
    model="qwen-image-2.0-pro",
    messages=messages,
    stream=False,
    n=1,
    watermark=False,
    negative_prompt=" ",
    prompt_extend=True,
    size="2048*2048",
)

if response.status_code == 200:
    # 如需查看完整响应,请取消下行注释
    # print(json.dumps(response, ensure_ascii=False))
    for i, content in enumerate(response.output.choices[0].message.content):
        print(f"输出图像{i+1}的URL:{content['image']}")
else:
    print(f"HTTP返回码:{response.status_code}")
    print(f"错误码:{response.code}")
    print(f"错误信息:{response.message}")
    print("请参考文档:https://help.aliyun.com/zh/model-studio/error-code")

响应示例

图像链接的有效期为24小时,请及时下载图像。
input_tokensoutput_tokenscharacters为兼容字段,当前固定为0。
{
    "status_code": 200,
    "request_id": "959afba6-544e-487e-b58a-6bd9fea97xxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ],
        "audio": null
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0,
        "height": 2048,
        "image_count": 1,
        "width": 2048
    }
}

Java SDK调用

推荐安装最新版DashScope Java SDK,否则可能运行报错:安装或升级SDK

请求示例

import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversation;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationParam;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationResult;
import com.alibaba.dashscope.common.MultiModalMessage;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.io.IOException;
import java.util.*;

public class QwenImageEdit {

    static {
        // 以下为华北2(北京)地域的URL。请将 {WorkspaceId} 替换为您的百炼业务空间ID,各地域的URL不同。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";
    }

    // 新加坡和北京地域的API Key不同。获取API Key:https://help.aliyun.com/zh/model-studio/get-api-key
    // 若没有配置环境变量,请用百炼 API Key 将下行替换为:apiKey="sk-xxx"
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void call() throws ApiException, NoApiKeyException, UploadFileException, IOException {

        MultiModalConversation conv = new MultiModalConversation();

        // 模型支持输入1-3张图片
        MultiModalMessage userMessage = MultiModalMessage.builder().role(Role.USER.getValue())
                .content(Arrays.asList(
                        Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260310/rdsgaa/image+%2815%29.png"),
                        Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260310/qokhtl/image+%2816%29.png"),
                        Collections.singletonMap("text", "使用图一的城市照片作为底图。请勿更改照片中的真实建筑、街道、车辆或人物。保持照片的真实性。三个图二中的卡通形象在建筑物周围,一个趴在建筑物上方,一个从建筑物的右边探出头来,一个坐在建筑物前的空地上。该形象应采用扁平化的图形风格绘制,轮廓清晰,类似于壁画或海报插图。")
                )).build();
        // qwen-image-2.0系列、qwen-image-edit-max、qwen-image-edit-plus系列支持输出1-6张图片
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("watermark", false);
        parameters.put("negative_prompt", " ");
        parameters.put("n", 1);
        parameters.put("prompt_extend", true);
        parameters.put("size", "2048*2048");

        MultiModalConversationParam param = MultiModalConversationParam.builder()
                .apiKey(apiKey)
                .model("qwen-image-2.0-pro")
                .messages(Collections.singletonList(userMessage))
                .parameters(parameters)
                .build();

        MultiModalConversationResult result = conv.call(param);
        // 如需查看完整响应,请取消下行注释
        // System.out.println(JsonUtils.toJson(result));
        List<Map<String, Object>> contentList = result.getOutput().getChoices().get(0).getMessage().getContent();
        int imageIndex = 1;
        for (Map<String, Object> content : contentList) {
            if (content.containsKey("image")) {
                System.out.println("输出图像" + imageIndex + "的URL:" + content.get("image"));
                imageIndex++;
            }
        }
    }

    public static void main(String[] args) {
        try {
            call();
        } catch (ApiException | NoApiKeyException | UploadFileException | IOException e) {
            System.out.println(e.getMessage());
        }
    }
}

响应示例

图像链接的有效期为24小时,请及时下载图像。
{
    "requestId": "5d5c3260-fc6c-4b4f-8b35-c06366effxxx",
    "usage": {
        "image_count": 1,
        "width": 2048,
        "height": 2048
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ]
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

错误码

如果模型调用失败并返回报错信息,请参见错误码进行解决。

计费与限流

常见问题

Q:千问图像编辑模型支持哪些语言?

A:目前正式支持简体中文和英文;其他语言可自行尝试,但效果存在不确定性。
Q: 如何查看模型调用量?
A: 模型调用完一小时后,请在模型监控(北京)模型监控(新加坡) 页面,查看模型的调用次数、成功率等指标。详情请参见账单查询与成本管理
Q:如何获取图像存储的访问域名白名单?
A: 模型生成的图像存储于阿里云OSS,API将返回一个临时的公网URL(链接有效期为 24 小时,请及时下载保存)。图片URL的域名格式为dashscope-{标识}.oss-accelerate.aliyuncs.comdashscope-{标识}.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格式输出。