Skip to main content
千問-早期映像模型

千問-影像編輯API參考

千問-影像編輯模型支援多圖輸入和多圖輸出,可精確修改圖內文字、增刪或移動物體、改變主體動作、遷移圖片風格及增強畫面細節。

模型概覽

輸入圖1

輸入圖2

輸入圖3

輸出映像(多圖)

image99

image98

image89

image100

imageout2

輸入提示詞:圖1中的女生穿著圖2中的黑色裙子按圖3的姿勢坐下。
模型名稱模型簡介輸出映像規格
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}.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/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 或 Base 64 編碼資料。支援傳入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. 傳入 Base 64 編碼映像後的字串
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,也不能保證每次產生結果完全一致。
  • 單圖編輯
  • 多圖融合
此處以使用qwen-image-2.0-pro模型輸出2張圖片為例。
curl --location 'https://{WorkspaceId}.ap-southeast-1.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/20250925/fpakfo/image36.webp"
                    },
                    {
                        "text": "產生一張符合深度圖的映像,遵循以下描述:一輛紅色的破舊的單車停在一條泥濘的小路上,背景是茂密的原始森林"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "n": 2,
        "negative_prompt": " ",
        "prompt_extend": true,
        "watermark": false,
        "size": "1536*1024"
    }
}'

響應參數

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": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                        },
                        {
                            "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ]
    },
    "usage": {
        "width": 1536,
        "image_count": 2,
        "height": 1024
    },
    "request_id": "bf37ca26-0abe-98e4-8065-xxxxxx"
}

DashScope SDK調用

SDK 的參數命名與HTTP介面基本一致,參數結構根據語言特性進行封裝,完整參數列表請參見千問 API 參考

Python SDK調用

  • 推薦安裝最新版DashScope Python SDK,否則可能運行報錯:安裝或升級SDK
  • 不支援非同步介面。

請求樣本

import json
import os
import dashscope
from dashscope import MultiModalConversation

# 以下為新加坡地區的URL。請將 {WorkspaceId} 替換為您的百鍊業務空間ID,各地區的URL不同。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 模型支援輸入1-3張圖片
messages = [
    {
        "role": "user",
        "content": [
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/thtclx/input1.png"},
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/iclsnx/input2.png"},
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/gborgw/input3.png"},
            {"text": "圖1中的女生穿著圖2中的黑色裙子按圖3的姿勢坐下"}
        ]
    }
]

# 新加坡和北京地區的API Key不同。擷取API Key:https://www.alibabacloud.com/help/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張圖片,此處以2張為例
response = MultiModalConversation.call(
    api_key=api_key,
    model="qwen-image-2.0-pro",
    messages=messages,
    stream=False,
    n=2,
    watermark=False,
    negative_prompt=" ",
    prompt_extend=True,
    size="1024*1536",
)

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://www.alibabacloud.com/help/zh/model-studio/error-code")

響應樣本

映像連結的有效期間為24小時,請及時下載映像。
input_tokensoutput_tokenscharacters為相容欄位,當前固定為0。
{
    "status_code": 200,
    "request_id": "fa41f9f9-3cb6-434d-a95d-4ae6b9xxxxxx",
    "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"
                        },
                        {
                            "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": 1536,
        "image_count": 2,
        "width": 1024
    }
}

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.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

import java.io.IOException;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.List;

public class QwenImageEdit {

    static {
        // 以下為新加坡地區的URL。請將 {WorkspaceId} 替換為您的百鍊業務空間ID,各地區的URL不同。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // 新加坡和北京地區的API Key不同。擷取API Key:https://www.alibabacloud.com/help/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/20250925/thtclx/input1.png"),
                        Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/iclsnx/input2.png"),
                        Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/gborgw/input3.png"),
                        Collections.singletonMap("text", "圖1中的女生穿著圖2中的黑色裙子按圖3的姿勢坐下")
                )).build();
        // qwen-image-2.0系列、qwen-image-edit-max、qwen-image-edit-plus系列支援輸出1-6張圖片,此處以2張為例
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("watermark", false);
        parameters.put("negative_prompt", " ");
        parameters.put("n", 2);
        parameters.put("prompt_extend", true);
        parameters.put("size", "1024*1536");

        MultiModalConversationParam param = MultiModalConversationParam.builder()
                .apiKey(apiKey)
                .model("qwen-image-edit-max")
                .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": "46281da9-9e02-941c-ac78-be88b8xxxxxx",
    "usage": {
        "image_count": 2,
        "width": 1024,
        "height": 1536
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                        },
                        {
                            "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ]
    }
}

錯誤碼

如果模型調用失敗並返回報錯資訊,請參見錯誤碼進行解決。

計費與限流

常見問題

Q:千問影像編輯模型支援哪些語言?

A:目前正式支援簡體中文和英文;其他語言可自行嘗試,但效果存在不確定性。
Q: 如何查看模型調用量?
A: 模型調用完一小時後,請在 模型监控(新加坡)模型监控(北京)頁面,查看模型的調用次數、成功率等指標。詳情請參見賬單查詢與成本管理
Q:如何擷取映像儲存的訪問網域名稱白名單?
A: 模型產生的映像儲存於阿里雲OSS,API將返回一個臨時的公網URL。若需要對該下載地址進行防火牆白名單配置,請注意:由於底層儲存會根據業務情況進行動態變更,為避免到期資訊影響訪問,文檔不提供固定的OSS網域名稱白名單。如有安全管控需求,請聯絡客戶經理擷取最新OSS網域名稱列表。