千問-影像編輯模型支援多圖輸入和多圖輸出,可精確修改圖內文字、增刪或移動物體、改變主體動作、遷移圖片風格及增強畫面細節。
模型概覽
輸入圖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 或 Base 64 編碼資料。支援傳入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)。
- 計費說明:按成功產生的 映像張數 計費。模型調用失敗或處理錯誤不產生任何費用,也不消耗新人免費額度。




