萬相-映像產生與編輯2.6 API參考 - Alibaba Cloud Model Studio

模型概覽

模型名稱

模型簡介

輸出映像規格

wan2.6-image

萬相2.6 image

支援影像編輯和圖文混排輸出

圖片格式：PNG。

映像解析度和尺寸請參見size參數。

說明

調用前，請查閱各地區支援的模型列表與價格。

前提條件

您需要已擷取API Key與API Host並配置API Key到環境變數（準備下線，併入配置 API Key）。請將範例程式碼中的 DASHSCOPE_API_HOST 替換為擷取的 API Host。

重要

新加坡、維吉尼亞和北京地區擁有獨立的 API Key 與請求地址，不可混用，跨地區調用將導致鑒權失敗或服務報錯，詳情請參見選擇部署模式。

HTTP同步調用

一次請求即可獲得結果，流程簡單，推薦大多數情境使用。

新加坡地區：POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

維吉尼亞地區：POST https://dashscope-us.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

北京地區：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

請求參數	影像編輯 curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \ --header 'Content-Type: application/json' \ --header "Authorization: Bearer $DASHSCOPE_API_KEY" \ --data '{ "model": "wan2.6-image", "input": { "messages": [ { "role": "user", "content": [ { "text": "參考圖1的風格和圖2的背景，產生番茄炒蛋" }, { "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png" }, { "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp" } ] } ] }, "parameters": { "prompt_extend": true, "watermark": false, "n": 1, "enable_interleave": false, "size": "12801280" } }' 圖文混排（僅支援流式）* 同步介面在啟用圖文混排輸出（即 `parameters.enable_interleave = true`）時，僅支援流式輸出，必須同時滿足以下兩項配置：設定`X-DashScope-Sse`為`enable`。設定`parameters.stream`為`true`。 `curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \ --header 'Content-Type: application/json' \ --header "Authorization: Bearer $DASHSCOPE_API_KEY" \ --header 'X-DashScope-Sse: enable' \ --data '{ "model": "wan2.6-image", "input": { "messages": [ { "role": "user", "content": [ { "text": "給我一個3張圖辣椒炒肉教程" } ] } ] }, "parameters": { "max_images": 3, "size": "1280*1280", "stream": true, "enable_interleave":true } }'`
要求標頭（Headers）
Content-Type `string` （必選）請求內容類型。此參數必須設定為`application/json`。
Authorization `string`（必選）請求身份認證。介面使用阿里雲百鍊API-Key進行身份認證。樣本值：Bearer sk-xxxx。
X-DashScope-Sse `string`（可選）用於啟用流式輸出。僅當 `parameters.enable_interleave=true` 時，必須將該欄位設為 `enable`。其他情況下可不傳或忽略。
請求體（Request Body）
model `string` （必選）模型名稱。設定為wan2.6-image。
input `object` （必選）輸入的基本資料。屬性 messages `array` （必選）請求內容數組。當前僅支援單輪對話，即傳入一組role、content參數，不支援多輪對話。屬性 role `string` （必選）訊息的角色。此參數固定設定為`user`。 content `array` （必選）訊息內容數組。屬性 text `string` （必選）正向提示詞用於描述您期望產生的映像內容、風格和構圖。支援中英文，長度不超過2000個字元，每個漢字、字母、數字或符號計為一個字元，超過部分會自動截斷。樣本值：參考這個風格的圖片，產生番茄炒蛋。注意：`content`數組中，必須且只能包含一個含 `text` 欄位的對象。 image `string` （可選）輸入映像的URL或Base64編碼字串。映像限制：映像格式：JPEG、JPG、PNG（不支援透明通道）、BMP、WEBP。映像解析度：映像的寬高範圍均為[384, 5000]像素。檔案大小：不超過10MB。映像數量限制：輸入映像數量與`parameters.enable_interleave`參數有關。當`enable_interleave=true`時（圖文混排輸出），可輸入0~1張映像。當`enable_interleave=false`時（影像編輯），必須輸入1~4張映像。當輸入多張映像時，需在`content`數組中傳入多個`image`對象，並按照數組順序定義映像順序。支援的輸入格式：使用公網可訪問URL 支援 HTTP 或 HTTPS 協議。樣本值：`http://wanx.alicdn.com/material/xxx.jpeg`。傳入 Base 64 編碼映像後的字串格式：data:{MIME_type};base64,{base64_data} 樣本：data:image/jpeg;base64,GDU7MtCZzEbTbmRZ...（僅示意，實際需傳入完整字串） Base 64 編碼規範請參見映像傳入方式。
parameters `object` （可選）影像處理參數。屬性 negative_prompt `string` （可選）反向提示詞，用於描述不希望在映像中出現的內容，對畫面進行限制。支援中英文，長度不超過500個字元，超出部分將自動截斷。樣本值：低解析度，低畫質，肢體畸形，手指畸形，畫面過飽和，蠟像感，人臉無細節，過度光滑，畫面具有AI感。構圖混亂。文字模糊，扭曲。 size `string` （可選）輸出映像的解析度，格式為`寬高`。 wan2.6-image：總像素在 [768768, 12801280] （即589824 至 1638400像素）之間，且寬高比範圍為 [1:4, 4:1]。例如，10241536符合要求。樣本值：12801280。常見比例推薦的解析度* 1:1：12801280 或 10241024 2:3：8001200 3:2：1200800 3:4：9601280 4:3：1280960 9:16：7201280 16:9：1280720 21:9：1344576 輸出映像尺寸的規則* 方式一：指定 `size` 參數：系統會以 `size` 指定的寬高為目標，將實際輸出映像的寬高調整為不大於指定值的、最大的16的倍數。方式二：未指定 `size`：輸出映像由總像素上限和寬高比規則共同決定。系統會根據總像素並按照寬高比規則對映像進行處理後輸出。總像素規則：由 `enable_interleave` 控制。當 `enable_interleave=true` 時：若輸入映像總像素 ≤ 12801280，輸出總像素與輸入一致；若輸入映像總像素 > 12801280，輸出總像素固定為 12801280。當 `enable_interleave=false` 時：輸出總像素固定為 12801280。寬高比規則（近似）：單圖輸入：輸出寬高比與輸入映像一致；多圖輸入：輸出寬高比與最後一張輸入映像一致。樣本：當 `enable_interleave=true` 且輸入 1 張 720720 的映像時，輸出映像為 720720，寬高比與輸入一致。 enable_interleave `bool` （可選）控制生圖模式： false：預設值，表示影像編輯模式（支援多圖輸入及主體一致性產生）。用途：基於1～4張輸入映像進行編輯、風格遷移或主體一致性產生。輸入：必須提供至少1張參考映像。輸出：可產生1至4張結果映像。 true ：表示啟用圖文混排輸出模式（僅支援傳入一張映像或不傳映像）。用途：根據文本描述產生圖文並茂的內容，或進行純文字產生映像（文生圖）。輸入：可以不提供映像（文生圖），或提供最多1張參考映像。輸出：產生包含文本和映像的混合內容。 n `integer` （可選）重要 n直接影響費用。費用 = 單價 × 成功產生的圖片張數，請在調用前確認模型價格。指定產生圖片的數量。該參數的取值範圍與含義取決於 enable_interleave（模式開關）的狀態：當 `enable_interleave=false`（影像編輯模式）：作用：直接控制產生映像的數量。取值範圍：1～4，預設值為 4。建議在測試階段將此值設定為 1，以便低成本驗證效果。當 `enable_interleave=true`（圖文混排模式）：限制：此參數預設為1，且必須固定為1。若設定為其他值，介面將報錯。說明：在此模式下，如需控制產生映像的數量上限，請使用 `max_images` 參數。 max_images `integer` （可選）重要 max_images影響費用。費用 = 單價 × 成功產生的圖片張數，請在調用前確認模型價格。僅在圖文混排模式（即 `enable_interleave=true`）下生效。作用：指定模型在單次回複中產生映像的最大數量。取值範圍：1～5，預設值為 5。注意：該參數僅代表“數量上限”。實際產生的映像數量由模型推理決定，可能會少於設定值（例如：設定為 5，模型可能根據內容僅產生 3 張）。 prompt_extend `bool` （可選）僅在影像編輯模式（即`enable_interleave = false`）下生效。是否開啟 Prompt（提示詞）智能改寫功能。該功能僅對正向提示詞進行最佳化與潤色，不會改變反向提示詞。 true：預設值，開啟智能改寫。 false：關閉智能改寫，使用原始提示詞。 stream `bool` （可選）控制返回結果是否為流式輸出。在映像混排模式（即 `enable_interleave = true`）下，必須設定為`true`。 false：預設值，非流式輸出。 true：流式輸出。 watermark `bool` （可選）是否添加浮水印標識，浮水印位於圖片右下角，文案固定為“AI產生”。 false：預設值，不添加浮水印。 true：添加浮水印。 seed `integer` （可選）隨機數種子，取值範圍`[0,2147483647]`。使用相同的`seed`參數值可使產生內容保持相對穩定。若不提供，演算法將自動使用隨機數種子。注意：模型產生過程具有機率性，即使使用相同的`seed`，也不能保證每次產生結果完全一致。

響應參數	任務執行成功任務資料（如任務狀態、映像URL等）僅保留24小時，逾時後會被自動清除。請您務必及時儲存產生的映像。 `{ "output": { "choices": [ { "finish_reason": "stop", "message": { "content": [ { "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx", "type": "image" } ], "role": "assistant" } } ], "finished": true }, "usage": { "image_count": 1, "input_tokens": 0, "output_tokens": 0, "size": "12801280", "total_tokens": 0 }, "request_id": "a3f4befe-cacd-49c9-8298-xxxxxx" }` 任務執行成功（流式輸出）任務資料（如任務狀態、映像URL等）僅保留24小時，逾時後會被自動清除。請您務必及時儲存產生的映像。 {"output":{"choices":[{"message":{"content":[{"type":"text","text":"肉"}],"role":"assistant"},"finish_reason":"null"}],"finished":true},"usage":{"total_tokens":571,"image_count":3,"output_tokens":543,"size":"12801280","input_tokens":28},"request_id":"d2dcb952-bf91-4a6a-aad5-xxxxxx"} {"output":{"choices":[{"message":{"content":[{"type":"text","text":"香"}],"role":"assistant"},"finish_reason":"null"}],"finished":true},"usage":{"total_tokens":572,"image_count":3,"output_tokens":544,"size":"12801280","input_tokens":28},"request_id":"d2dcb952-bf91-4a6a-aad5-xxxxxx"} {"output":{"choices":[{"message":{"content":[{"type":"text","text":"交織"}],"role":"assistant"},"finish_reason":"null"}],"finished":true},"usage":{"total_tokens":573,"image_count":3,"output_tokens":545,"size":"12801280","input_tokens":28},"request_id":"d2dcb952-bf91-4a6a-aad5-xxxxxx"} ...... {"output":{"choices":[{"message":{"content":[{"type":"image","image":"https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxxx"}],"role":"assistant"},"finish_reason":"null"}],"finished":true},"usage":{"total_tokens":557,"image_count":3,"output_tokens":529,"size":"12801280","input_tokens":28},"request_id":"d2dcb952-bf91-4a6a-aad5-xxxxxx"} {"output":{"choices":[{"message":{"content":[{"type":"text","text":"趁"}],"role":"assistant"},"finish_reason":"null"}],"finished":true},"usage":{"total_tokens":558,"image_count":3,"output_tokens":530,"size":"12801280","input_tokens":28},"request_id":"d2dcb952-bf91-4a6a-aad5-xxxxxx"} {"output":{"choices":[{"message":{"content":[{"type":"text","text":"熱"}],"role":"assistant"},"finish_reason":"null"}],"finished":true},"usage":{"total_tokens":559,"image_count":3,"output_tokens":531,"size":"12801280","input_tokens":28},"request_id":"d2dcb952-bf91-4a6a-aad5-xxxxxx"} {"output":{"choices":[{"message":{"content":[{"type":"text","text":"夾"}],"role":"assistant"},"finish_reason":"null"}],"finished":true},"usage":{"total_tokens":560,"image_count":3,"output_tokens":532,"size":"12801280","input_tokens":28},"request_id":"d2dcb952-bf91-4a6a-aad5-xxxxxx"} {"output":{"choices":[{"message":{"content":[{"type":"text","text":"起"}],"role":"assistant"},"finish_reason":"null"}],"finished":true},"usage":{"total_tokens":561,"image_count":3,"output_tokens":533,"size":"12801280","input_tokens":28},"request_id":"d2dcb952-bf91-4a6a-aad5-xxxxxx"} {"output":{"choices":[{"message":{"content":[{"type":"text","text":"一塊"}],"role":"assistant"},"finish_reason":"null"}],"finished":true},"usage":{"total_tokens":562,"image_count":3,"output_tokens":534,"size":"12801280","input_tokens":28},"request_id":"d2dcb952-bf91-4a6a-aad5-xxxxxx"} {"output":{"choices":[{"message":{"content":[{"type":"text","text":"肉"}],"role":"assistant"},"finish_reason":"stop"}],"finished":true},"usage":{"total_tokens":563,"image_count":3,"output_tokens":535,"size":"1280*1280","input_tokens":28},"request_id":"d2dcb952-bf91-4a6a-aad5-xxxxxx"} 任務執行異常如果因為某種原因導致任務執行失敗，將返回相關資訊，可以通過code和message欄位明確指示錯誤原因。請參見錯誤資訊進行解決。 `{ "request_id": "a4d78a5f-655f-9639-8437-xxxxxx", "code": "InvalidParameter", "message": "num_images_per_prompt must be 1" }`
output `object` 任務輸出資訊。屬性 choices `array of object` 模型產生的輸出內容。屬性 finish_reason `string` 任務停止原因。非流式輸出情境：自然停止時為`stop`。流式輸出情境：當開啟流式輸出時，該參數判斷資料流是否傳輸結束。傳輸過程中：前序資料包會持續返回 `"finish_reason": "null"`，表示內容仍在產生中，請繼續接收。傳輸結束時：僅在最後一個 JSON 結構體中返回 `"finish_reason":"stop"`，表示流式請求已全部結束，應停止接收。 message `object` 模型返回的訊息。屬性 role `string` 訊息的角色，固定為`assistant`。 content `array` 屬性 type `string` 輸出的類型，枚舉值為text、image。 text `string` 產生的文字。 image `string` 產生映像的 URL，映像格式為PNG。連結有效期間為24小時，請及時下載並儲存映像。 finished `bool` 請求結束標誌符。 true：表示請求結束。 false：表示請求未結束。
usage `object` 輸出資訊統計。只對成功的結果計數。屬性 image_count `integer` 產生映像的張數。 size `string` 產生的映像解析度。樣本值：12801280。 input_tokens* `integer` 按圖片張數計費。在影像編輯模式下，固定為0。在圖文混排模式下，此欄位統計輸入文本的token數量（不計費）。 output_tokens `integer` 按圖片張數計費。在影像編輯模式下，固定為0。在圖文混排模式下，此欄位統計輸出文本的token數量（不計費）。 total_tokens `integer` 按圖片張數計費。在影像編輯模式下，固定為0。在圖文混排模式下，此欄位統計總token數量（不計費）。
request_id `string` 請求唯一標識。可用於請求明細溯源和問題排查。
code `string` 請求失敗的錯誤碼。請求成功時不會返回此參數，詳情請參見錯誤資訊。
message `string` 請求失敗的詳細資料。請求成功時不會返回此參數，詳情請參見錯誤資訊。

HTTP非同步呼叫

由於映像產生任務耗時較長（通常為1-2分鐘），API採用非同步呼叫以避免請求逾時。整個流程包含 “建立任務 -> 輪詢擷取” 兩個核心步驟，具體如下：

步驟1：建立任務擷取任務ID

新加坡地區：POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image-generation/generation

維吉尼亞地區：POST https://dashscope-us.aliyuncs.com/api/v1/services/aigc/image-generation/generation

北京地區：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation

說明

建立成功後，使用介面返回的 task_id 查詢結果，task_id 有效期間為 24 小時。請勿重複建立任務，輪詢擷取即可。
新手指引請參見Postman。

請求參數	影像編輯 curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \ --header 'Content-Type: application/json' \ --header "Authorization: Bearer $DASHSCOPE_API_KEY" \ --header 'X-DashScope-Async: enable' \ --data '{ "model": "wan2.6-image", "input": { "messages": [ { "role": "user", "content": [ { "text": "參考圖1的風格和圖2的背景，產生番茄炒蛋" }, { "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png" }, { "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp" } ] } ] }, "parameters": { "prompt_extend": true, "watermark": false, "n": 1, "enable_interleave": false, "size": "12801280" } }' 圖文混排輸出 `curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \ --header 'Content-Type: application/json' \ --header "Authorization: Bearer $DASHSCOPE_API_KEY" \ --header 'X-DashScope-Async: enable' \ --data '{ "model": "wan2.6-image", "input": { "messages": [ { "role": "user", "content": [ { "text": "給我一個3張圖辣椒炒肉教程" } ] } ] }, "parameters": { "max_images": 3, "size": "12801280", "enable_interleave":true } }'`
要求標頭（Headers）
Content-Type `string` （必選）請求內容類型。此參數必須設定為`application/json`。
Authorization `string`（必選）請求身份認證。介面使用阿里雲百鍊API-Key進行身份認證。樣本值：Bearer sk-xxxx。
X-DashScope-Async `string` （必選）非同步處理配置參數，必須設定為`enable`。重要缺少此要求標頭將報錯：“current user api does not support synchronous calls”。
請求體（Request Body）
model `string` （必選）模型名稱。樣本值：wan2.6-image。
input `object` （必選）輸入的基本資料。屬性 messages `array` （必選）請求內容數組。當前僅支援單輪對話，即傳入一組role、content參數，不支援多輪對話。屬性 role `string` （必選）訊息的角色。此參數固定設定為`user`。 content `array` （必選）訊息內容數組。屬性 text `string` （必選）正向提示詞用於描述您期望產生的映像內容、風格和構圖。支援中英文，長度不超過2000個字元，每個漢字、字母、數字或符號計為一個字元，超過部分會自動截斷。樣本值：參考這個風格的圖片，產生番茄炒蛋。注意：`content`數組中，必須且只能包含一個含 `text` 欄位的對象。 image `string` （可選）輸入映像的URL或Base64編碼字串。映像限制：映像格式：JPEG、JPG、PNG（不支援透明通道）、BMP、WEBP。映像解析度：映像的寬高範圍均為[384, 5000]像素。檔案大小：不超過10MB。映像數量限制：輸入映像數量與`parameters.enable_interleave`參數有關。當`enable_interleave=true`時（圖文混排輸出），可輸入0~1張映像。當`enable_interleave=false`時（影像編輯），必須輸入1~4張映像。當輸入多張映像時，需在`content`數組中傳入多個`image`對象，並按照數組順序定義映像順序。支援的輸入格式：使用公網可訪問URL 支援 HTTP 或 HTTPS 協議。樣本值：`http://wanx.alicdn.com/material/xxx.jpeg`。傳入 Base 64 編碼映像後的字串格式：data:{MIME_type};base64,{base64_data} 樣本：data:image/jpeg;base64,GDU7MtCZzEbTbmRZ...（僅示意，實際需傳入完整字串） Base 64 編碼規範請參見映像傳入方式。
parameters `object` （可選）影像處理參數。屬性 negative_prompt `string` （可選）反向提示詞，用於描述不希望在映像中出現的內容，對畫面進行限制。支援中英文，長度不超過500個字元，超出部分將自動截斷。樣本值：低解析度，低畫質，肢體畸形，手指畸形，畫面過飽和，蠟像感，人臉無細節，過度光滑，畫面具有AI感。構圖混亂。文字模糊，扭曲。 size `string` （可選）輸出映像的解析度，格式為`寬高`。 wan2.6-image：總像素在 [768768, 12801280] （即589824 至 1638400像素）之間，且寬高比範圍為 [1:4, 4:1]。例如，10241536符合要求。樣本值：12801280。常見比例推薦的解析度* 1:1：12801280 或 10241024 2:3：8001200 3:2：1200800 3:4：9601280 4:3：1280960 9:16：7201280 16:9：1280720 21:9：1344576 輸出映像尺寸的規則* 方式一：指定 `size` 參數：系統會以 `size` 指定的寬高為目標，將實際輸出映像的寬高調整為不大於指定值的、最大的16的倍數。方式二：未指定 `size`：輸出映像由總像素上限和寬高比規則共同決定。系統會根據總像素並按照寬高比規則對映像進行處理後輸出。總像素規則：由 `enable_interleave` 控制。當 `enable_interleave=true` 時：若輸入映像總像素 ≤ 12801280，輸出總像素與輸入一致；若輸入映像總像素 > 12801280，輸出總像素固定為 12801280。當 `enable_interleave=false` 時：輸出總像素固定為 12801280。寬高比規則（近似）：單圖輸入：輸出寬高比與輸入映像一致；多圖輸入：輸出寬高比與最後一張輸入映像一致。樣本：當 `enable_interleave=true` 且輸入 1 張 720720 的映像時，輸出映像為 720720，寬高比與輸入一致。 enable_interleave `bool` （可選）控制生圖模式： false：預設值，表示影像編輯模式（支援多圖輸入及主體一致性產生）。用途：基於1～4張輸入映像進行編輯、風格遷移或主體一致性產生。輸入：必須提供至少1張參考映像。輸出：可產生1至4張結果映像。 true ：表示啟用圖文混排輸出模式（僅支援傳入一張映像或不傳映像）。用途：根據文本描述產生圖文並茂的內容，或進行純文字產生映像（文生圖）。輸入：可以不提供映像（文生圖），或提供最多1張參考映像。輸出：產生包含文本和映像的混合內容。 n `integer` （可選）重要 n直接影響費用。費用 = 單價 × 成功產生的圖片張數，請在調用前確認模型價格。指定產生圖片的數量。該參數的取值範圍與含義取決於 enable_interleave（模式開關）的狀態：當 `enable_interleave=false`（影像編輯模式）：作用：直接控制產生映像的數量。取值範圍：1～4，預設值為 4。建議在測試階段將此值設定為 1，以便低成本驗證效果。當 `enable_interleave=true`（圖文混排模式）：限制：此參數預設為1，且必須固定為1。若設定為其他值，介面將報錯。說明：在此模式下，如需控制產生映像的數量上限，請使用 `max_images` 參數。 max_images `integer` （可選）重要 max_images影響費用。費用 = 單價 × 成功產生的圖片張數，請在調用前確認模型價格。僅在圖文混排模式（即 `enable_interleave=true`）下生效。作用：指定模型在單次回複中產生映像的最大數量。取值範圍：1～5，預設值為 5。注意：該參數僅代表“數量上限”。實際產生的映像數量由模型推理決定，可能會少於設定值（例如：設定為 5，模型可能根據內容僅產生 3 張）。 prompt_extend `bool` （可選）僅在影像編輯模式（即`enable_interleave = false`）下生效。是否開啟 Prompt（提示詞）智能改寫功能。該功能僅對正向提示詞進行最佳化與潤色，不會改變反向提示詞。 true：預設值，開啟智能改寫。 false：關閉智能改寫，使用原始提示詞。 watermark `bool` （可選）是否添加浮水印標識，浮水印位於圖片右下角，文案固定為“AI產生”。 false：預設值，不添加浮水印。 true：添加浮水印。 seed `integer` （可選）隨機數種子，取值範圍`[0,2147483647]`。使用相同的`seed`參數值可使產生內容保持相對穩定。若不提供，演算法將自動使用隨機數種子。注意：模型產生過程具有機率性，即使使用相同的`seed`，也不能保證每次產生結果完全一致。

響應參數	成功響應請儲存 task_id，用於查詢任務狀態與結果。 `{ "output": { "task_status": "PENDING", "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx" }, "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx" }` 異常響應建立任務失敗，請參見錯誤資訊進行解決。 `{ "code": "InvalidApiKey", "message": "No API-key provided.", "request_id": "7438d53d-6eb8-4596-8835-xxxxxx" }`
output `object` 任務輸出資訊。屬性 task_id `string` 任務ID。查詢有效期間24小時。 task_status `string` 任務狀態。枚舉值 PENDING：任務排隊中 RUNNING：任務處理中 SUCCEEDED：任務執行成功 FAILED：任務執行失敗 CANCELED：任務已取消 UNKNOWN：任務不存在或狀態未知
request_id `string` 請求唯一標識。可用於請求明細溯源和問題排查。
code `string` 請求失敗的錯誤碼。請求成功時不會返回此參數，詳情請參見錯誤資訊。
message `string` 請求失敗的詳細資料。請求成功時不會返回此參數，詳情請參見錯誤資訊。

步驟2：根據任務ID查詢結果

新加坡地區：GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id}

維吉尼亞地區：GET https://dashscope-us.aliyuncs.com/api/v1/tasks/{task_id}

北京地區：GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

說明

輪詢建議：映像產生過程較長，建議採用輪詢機制，並設定合理的查詢間隔（如 10 秒）來擷取結果。
任務狀態流轉：PENDING（排隊中）→ RUNNING（處理中）→ SUCCEEDED（成功）/ FAILED（失敗）。
結果連結：任務成功後返回映像連結，有效期間為 24 小時。建議在擷取連結後立即下載並轉存至永久儲存（如阿里雲 OSS）。

請求參數	查詢任務結果將`{task_id}`完整替換為上一步介面返回的`task_id`的值。 `curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id} \ --header "Authorization: Bearer $DASHSCOPE_API_KEY"`
要求標頭（Headers）
Authorization `string`（必選）請求身份認證。介面使用阿里雲百鍊API-Key進行身份認證。樣本值：Bearer sk-xxxx。
URL路徑參數（Path parameters）
task_id `string`（必選）任務ID。

響應參數	任務執行成功任務資料（如任務狀態、映像URL等）僅保留24小時，逾時後會被自動清除。請您務必及時儲存產生的映像。 { "request_id": "43d9e959-25bc-4dc7-9888-xxxxxx", "output": { "task_id": "858cad55-4bdc-4ba3-ae6c-xxxxxx", "task_status": "SUCCEEDED", "submit_time": "2025-12-16 04:21:02.275", "scheduled_time": "2025-12-16 04:21:02.304", "end_time": "2025-12-16 04:24:46.658", "finished": true, "choices": [ { "finish_reason": "stop", "message": { "role": "assistant", "content": [ { "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1xxx.png?Expires=xxx", "type": "image" } ] } }, { "finish_reason": "stop", "message": { "role": "assistant", "content": [ { "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1xxx.png?Expires=xxx", "type": "image" } ] } } ] }, "usage": { "size": "1280*1280", "total_tokens": 0, "image_count": 2, "output_tokens": 0, "input_tokens": 0 } } 任務執行異常如果因為某種原因導致任務執行失敗，將返回相關資訊，可以通過code和message欄位明確指示錯誤原因。請參見錯誤資訊進行解決。 `{ "request_id": "a4d78a5f-655f-9639-8437-xxxxxx", "code": "InvalidParameter", "message": "num_images_per_prompt must be 1" }`
output `object` 任務輸出資訊。屬性 task_id `string` 任務ID。查詢有效期間24小時。 task_status `string` 任務狀態。枚舉值 PENDING：任務排隊中 RUNNING：任務處理中 SUCCEEDED：任務執行成功 FAILED：任務執行失敗 CANCELED：任務已取消 UNKNOWN：任務不存在或狀態未知輪詢過程中的狀態流轉： PENDING（排隊中） → RUNNING（處理中）→ SUCCEEDED（成功）/ FAILED（失敗）。初次查詢狀態通常為 PENDING（排隊中）或 RUNNING（處理中）。當狀態變為 SUCCEEDED 時，響應中將包含產生的映像url。若狀態為 FAILED，請檢查錯誤資訊並重試。 submit_time `string` 任務提交時間。時區為UTC+8，格式為 YYYY-MM-DD HH:mm:ss.SSS。 scheduled_time `string` 任務執行時間。時區為UTC+8，格式為 YYYY-MM-DD HH:mm:ss.SSS。 end_time `string` 任務完成時間。時區為UTC+8，格式為 YYYY-MM-DD HH:mm:ss.SSS。 finished `bool` 請求結束標誌符。 true：表示請求結束。 false：表示請求未結束。 choices `array of object` 模型產生的輸出內容。屬性 finish_reason `string` 任務停止原因，自然停止時為`stop`。 message `object` 模型返回的訊息。屬性 role `string` 訊息的角色，固定為`assistant`。 content `array` 屬性 type `string` 輸出的類型，枚舉值為text、image。 text `string` 產生的文字。 image `string` 產生映像的 URL，映像格式為PNG。連結有效期間為24小時，請及時下載並儲存映像。
usage `object` 輸出資訊統計。只對成功的結果計數。屬性 image_count `integer` 產生映像的張數。 size `string` 產生的映像解析度。樣本值：12801280。 input_tokens* `integer` 輸入token數量。按圖片張數計費，當前固定為0。 output_tokens `integer` 輸出token數量。按圖片張數計費，當前固定為0。 total_tokens `integer` 總token數量。按圖片張數計費，當前固定為0。
request_id `string` 請求唯一標識。可用於請求明細溯源和問題排查。
code `string` 請求失敗的錯誤碼。請求成功時不會返回此參數，詳情請參見錯誤資訊。
message `string` 請求失敗的詳細資料。請求成功時不會返回此參數，詳情請參見錯誤資訊。

DashScope Python SDK調用

SDK 的參數命名與HTTP介面基本一致，參數結構根據語言特性進行封裝。

由於任務耗時較長，SDK 在底層封裝了 HTTP 非同步呼叫流程，支援同步、非同步兩種調用方式。

重要

請確保 DashScope Python SDK 版本不低於 1.25.8，再運行以下代碼。更新請參考安裝SDK。

各地區的base_url和 API Key 不通用，以下樣本以新加坡地區為例進行調用：

新加坡地區：https://dashscope-intl.aliyuncs.com/api/v1

維吉尼亞地區：https://dashscope-us.aliyuncs.com/api/v1

北京地區：https://dashscope.aliyuncs.com/api/v1

影像編輯

同步調用

請求樣本

import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# 以下為新加坡地區base_url，各地區的base_url不同
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx"
# 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

message = Message(
    role="user",
    # 支援本地檔案 如 "image": "file://umbrella1.png"
    content=[
        {
            "text": "參考圖1的風格和圖2的背景，產生番茄炒蛋"
        },
        {
            "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
        },
        {
            "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
        }
    ]
)
print("----sync call, please wait a moment----")
rsp = ImageGeneration.call(
        model='wan2.6-image',
        api_key=api_key,
        messages=[message],
        negative_prompt="",
        prompt_extend=True,
        watermark=False,
        n=1,
        enable_interleave=False,
        size="1280*1280"
    )

print(rsp)

響應樣本

{
    "status_code": 200,
    "request_id": "b6a4c68d-3a91-4018-ae96-3cf373xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "audio": null,
        "finished": true
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0,
        "image_count": 1,
        "size": "1280*1280",
        "total_tokens": 0
    }
}

非同步呼叫

請求樣本

import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message
from http import HTTPStatus

# 以下為新加坡地區base_url，各地區的base_url不同
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx"
# 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

# 建立非同步任務
def create_async_task():
    print("Creating async task...")
    message = Message(
        role="user",
        content=[
            {'text': '參考圖1的風格和圖2的背景，產生番茄炒蛋'},
            {'image': 'https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png'},
            {'image': 'https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp'}
        ]
    )
    response = ImageGeneration.async_call(
        model="wan2.6-image",
        api_key=api_key,
        messages=[message],
        negative_prompt="",
        prompt_extend=True,
        watermark=False,
        n=1,
        enable_interleave=False,
        size="1280*1280"
    )
    
    if response.status_code == 200:
        print("Task created successfully:", response)
        return response  # 返回任務ID
    else:
        raise Exception(f"Failed to create task: {response.code} - {response.message}")

# 等待任務完成
def wait_for_completion(task_response):
    print("Waiting for task completion...")
    status = ImageGeneration.wait(task=task_response, api_key=api_key)
    
    if status.output.task_status == "SUCCEEDED":
        print("Task succeeded!")
        print("Response:", status)
    else:
        raise Exception(f"Task failed with status: {status.output.task_status}")

# 擷取非同步任務資訊
def fetch_task_status(task):
    print("Fetching task status...")
    status = ImageGeneration.fetch(task=task, api_key=api_key)
    
    if status.status_code == HTTPStatus.OK:
        print("Task status:", status.output.task_status)
        print("Response details:", status)
    else:
        print(f"Failed to fetch status: {status.code} - {status.message}")

# 取消非同步任務
def cancel_task(task):
    print("Canceling task...")
    response = ImageGeneration.cancel(task=task, api_key=api_key)
    
    if response.status_code == HTTPStatus.OK:
        print("Task canceled successfully:", response.output.task_status)
    else:
        print(f"Failed to cancel task: {response.code} - {response.message}")

# 主執行流程
if __name__ == "__main__":
    task = create_async_task()
    wait_for_completion(task)

響應樣本

1、建立任務的響應樣本

{
    "status_code": 200,
    "request_id": "4fb3050f-de57-4a24-84ff-e37ee5xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": null,
        "audio": null,
        "task_id": "127ec645-118f-4884-955d-0eba8dxxxxxx",
        "task_status": "PENDING"
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0
    }
}

2、查詢任務結果的響應樣本

{
    "status_code": 200,
    "request_id": "b2a7fab4-5e00-4b0a-86fe-8b9964xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "audio": null,
        "task_id": "127ec645-118f-4884-955d-0eba8xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-01-09 17:52:04.136",
        "scheduled_time": "2026-01-09 17:52:04.164",
        "end_time": "2026-01-09 17:52:25.408",
        "finished": true
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0,
        "size": "1280*1280",
        "total_tokens": 0,
        "image_count": 1
    }
}

圖文混合輸出

同步調用（僅支援流式）

請求樣本

import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# 以下為新加坡地區url，各地區的base_url不同
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx"
# 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")


def sync_call_with_stream():
    print("\n========== 同步調用 - 流式圖文輸出 ==========")

    image_message = Message(
        role="user",
        content=[
            {
                "text": "給我一個3張圖辣椒炒肉教程"
            }
        ]
    )

    image_stream_res = ImageGeneration.call(
        model="wan2.6-image",
        api_key=api_key,
        messages=[image_message],
        stream=True,  # 僅支援流式調用
        negative_prompt="",
        enable_interleave=True,
        max_images=3,
        size="1280*1280"
    )

    print("流式輸出結果:")
    for stream_res in image_stream_res:
        print(stream_res)

if __name__ == "__main__":
    sync_call_with_stream()

響應樣本

{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "辣椒"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 0, "characters": 0, "total_tokens": 28, "image_count": 0, "size": "0*0"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "炒"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 1, "characters": 0, "total_tokens": 29, "image_count": 0, "size": "0*0"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "肉"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 2, "characters": 0, "total_tokens": 30, "image_count": 0, "size": "0*0"}}

......

{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "。"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 398, "characters": 0, "total_tokens": 426, "image_count": 2, "size": "1280*1280"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "stop", "message": {"role": "assistant", "content": [{"type": "image", "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}], "audio": null, "finished": true}, "usage": {"input_tokens": 28, "output_tokens": 523, "characters": 0, "total_tokens": 551, "image_count": 3, "size": "1280*1280"}}

非同步呼叫

請求樣本

注意：非同步呼叫不需要設定stream參數

import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message
from http import HTTPStatus

# 以下為新加坡地區url，各地區的base_url不同
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'

# 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx"
# 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")


def main():
    """非同步呼叫 - 圖文輸出"""
    print("========== wan2.6-image 非同步呼叫 - 圖文輸出 ==========")

    image_message = Message(
        role="user",
        content=[
            {
                "text": "給我一個3張圖的辣椒炒肉教程"
            }
        ]
    )

    # 建立非同步任務
    print("---async call, creating task----")
    response = ImageGeneration.async_call(
        model="wan2.6-image",
        api_key=api_key,
        messages=[image_message],
        # 非同步呼叫不需要設定stream參數
        negative_prompt="",
        enable_interleave=True,
        max_images=3,
        size="1280*1280"
    )

    if response.status_code == HTTPStatus.OK:
        print(f"任務建立成功:")
        print(response)

        # 等待任務完成
        print("\n---waiting for task completion----")
        status = ImageGeneration.wait(task=response, api_key=api_key)

        if status.output.task_status == "SUCCEEDED":
            print("任務完成!")
            print(f"結果:")
            print(status)
        else:
            print(f"任務失敗，狀態: {status.output.task_status}")
    else:
        print(f"任務建立失敗: {response.code} - {response.message}")


if __name__ == "__main__":
    try:
        main()
    except Exception as e:
        print(f"執行出錯: {str(e)}")
        import traceback
        traceback.print_exc()

響應樣本

1、建立任務的響應樣本

{
    "status_code": 200,
    "request_id": "4fb3050f-de57-4a24-84ff-e37ee5xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": null,
        "audio": null,
        "task_id": "5c67585e-a3be-4943-b04d-c3fbb2xxxxxx",
        "task_status": "PENDING"
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0
    }
}

2、查詢任務結果的響應樣本

{
    "status_code": 200,
    "request_id": "997a759b-fbb9-4b35-9a4d-6dab1xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "text": "辣椒炒肉是湘菜中的經典，也是許多人心中的家常美味。它以鮮辣爽口、肉質鮮嫩而聞名，製作過程簡單，卻能帶來極致的味蕾享受。今天，我們就來一起學習這道菜的製作方法。\n\n首先，準備好所有食材是成功的第一步。新鮮的豬肉、紅綠辣椒、蒜瓣和薑片是必不可少的。將豬肉切成薄片，辣椒切段，蒜和薑切片備用。",
                            "type": "text"
                        },
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        },
                        {
                            "text": "接下來是炒制的關鍵環節。熱鍋涼油，放入蒜片和薑片爆香，接著倒入切好的肉片，快速翻炒至肉片變色。肉片炒香後，加入切好的辣椒段，繼續翻炒，讓辣椒的香氣充分釋放出來，與肉片的鮮美完美融合。",
                            "type": "text"
                        },
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        },
                        {
                            "text": "最後，加入適量的生抽、老抽、蠔油和少許糖調味，快速翻炒均勻，讓每一片肉和辣椒都裹上醬汁。待湯汁收濃，即可關火出鍋。這道色香味俱全的辣椒炒肉就大功告成了！",
                            "type": "text"
                        },
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "audio": null,
        "task_id": "5c67585e-a3be-4943-b04d-c3fbb2xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-01-16 17:47:39.469",
        "scheduled_time": "2026-01-16 17:47:39.804",
        "end_time": "2026-01-16 17:49:46.736",
        "finished": true
    },
    "usage": {
        "input_tokens": 29,
        "output_tokens": 477,
        "characters": 0,
        "size": "1280*1280",
        "total_tokens": 506,
        "image_count": 3
    }
}

DashScope Java SDK調用

SDK 的參數命名與HTTP介面基本一致，參數結構根據語言特性進行封裝。

由於任務耗時較長，SDK 在底層封裝了 HTTP 非同步呼叫流程，支援同步、非同步兩種調用方式。

重要

請確保 DashScope Java SDK 版本不低於 2.22.6，再運行以下代碼。

各地區的base_url和 API Key 不通用，以下樣本以新加坡地區為例進行調用：

新加坡地區：https://dashscope-intl.aliyuncs.com/api/v1

維吉尼亞地區：https://dashscope-us.aliyuncs.com/api/v1

北京地區：https://dashscope.aliyuncs.com/api/v1

影像編輯

同步調用

請求樣本

import com.alibaba.dashscope.aigc.imagegeneration.*;
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.util.Arrays;
import java.util.Collections;

/**
 * wan2.6-image 影像編輯 - 同步調用樣本
 */
public class Main {

    static {
        // 以下為新加坡地區url，各地區的base_url不同
        Constants.baseHttpApiUrl = "https://dashscope-intl.aliyuncs.com/api/v1";
    }

    // 若沒有配置環境變數，請用百鍊API Key將下行替換為：apiKey="sk-xxx"
    // 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void basicCall() throws ApiException, NoApiKeyException, UploadFileException {
        // 構建多圖輸入訊息
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Arrays.asList(
                        // 支援多圖輸入，可以提供多張參考圖片
                        Collections.singletonMap("text", "參考圖1的風格和圖2的背景，產生番茄炒蛋"),
                        Collections.singletonMap("image", "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"),
                        Collections.singletonMap("image", "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp")
                )).build();

        // 影像編輯使用普通同步調用，不需要設定stream和enable_interleave
        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.6-image")
                .messages(Collections.singletonList(message))
                .n(1)
                .size("1280*1280")
                .negativePrompt("")
                .promptExtend(true)
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        ImageGenerationResult result = null;
        try {
            System.out.println("---sync call for image editing, please wait a moment----");
            result = imageGeneration.call(param);
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
        System.out.println(JsonUtils.toJson(result));
    }

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

響應樣本

{
    "requestId": "b148327e-830f-414c-a8df-724dec28exxx",
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "total_tokens": 0,
        "image_count": 1,
        "size": "1280*1280"
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "finished": true
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

非同步呼叫

請求樣本

import com.alibaba.dashscope.aigc.imagegeneration.*;
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.util.Arrays;
import java.util.Collections;

/**
 * wan2.6-image 影像編輯 - 非同步呼叫樣本
 */
public class Main {

    static {
        // 以下為新加坡地區url，各地區的base_url不同
        Constants.baseHttpApiUrl = "https://dashscope-intl.aliyuncs.com/api/v1";
    }

    // 若沒有配置環境變數，請用百鍊API Key將下行替換為：apiKey="sk-xxx"
    // 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void asyncCall() throws ApiException, NoApiKeyException, UploadFileException {
        // 構建多圖輸入訊息
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Arrays.asList(
                        // 支援多圖輸入，可以提供多張參考圖片
                        Collections.singletonMap("text", "參考圖1的風格和圖2的背景，產生番茄炒蛋"),
                        Collections.singletonMap("image", "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"),
                        Collections.singletonMap("image", "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp")
                )).build();

        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.6-image")
                .n(1)
                .size("1280*1280")
                .negativePrompt("")
                .promptExtend(true)
                .messages(Arrays.asList(message))
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        ImageGenerationResult result = null;
        try {
            System.out.println("---async call for image editing, creating task----");
            result = imageGeneration.asyncCall(param);
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
        System.out.println("任務建立結果:");
        System.out.println(JsonUtils.toJson(result));

        String taskId = result.getOutput().getTaskId();
        // 等待任務完成
        waitTask(taskId);
    }

    public static void waitTask(String taskId) throws ApiException, NoApiKeyException {
        ImageGeneration imageGeneration = new ImageGeneration();
        System.out.println("\n---waiting for task completion----");
        ImageGenerationResult result = imageGeneration.wait(taskId, apiKey);
        System.out.println("任務完成結果:");
        System.out.println(JsonUtils.toJson(result));
    }

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

響應樣本

1、建立任務的響應樣本

{
    "status_code": 200,
    "request_id": "9cd85950-2e26-4b2c-b562-1694cf928xxx",
    "code": "",
    "message": "",
    "output": {
        "task_id": "4c861fbe-af89-4a2f-8fc5-4bb15c313xxx",
        "task_status": "PENDING"
    },
    "usage": null
}

2、查詢任務結果的響應樣本

{
    "status_code": 200,
    "request_id": "cbdf1424-306e-4a52-82f3-8bf5d8a99xxx",
    "code": "",
    "message": "",
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "task_id": "4c861fbe-af89-4a2f-8fc5-4bb15c3139ba",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-01-16 16:36:06.556",
        "scheduled_time": "2026-01-16 16:36:06.591",
        "end_time": "2026-01-16 16:36:25.190",
        "finished": true
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "size": "1280*1280",
        "total_tokens": 0,
        "image_count": 1
    }
}

圖文混合輸出

同步調用（僅支援流式）

請求樣本

import com.alibaba.dashscope.aigc.imagegeneration.*;
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 io.reactivex.Flowable;

import java.util.Collections;

/**
 * wan2.6-image 圖文輸出 - 流式調用樣本
 */
public class Main {

    static {
        // 以下為新加坡地區url，各地區的base_url不同
        Constants.baseHttpApiUrl = "https://dashscope-intl.aliyuncs.com/api/v1";
    }

    // 若沒有配置環境變數，請用百鍊API Key將下行替換為：apiKey="sk-xxx"
    // 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void streamCall() throws ApiException, NoApiKeyException, UploadFileException {
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Collections.singletonList(
                        Collections.singletonMap("text", "給我一個3張圖辣椒炒肉教程")
                )).build();

        // 圖文輸出必須使用流式調用
        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.6-image")
                .messages(Collections.singletonList(message))
                .stream(true) // 必須開啟流式輸出
                .enableInterleave(true)
                .size("1280*1280")
                .negativePrompt("")
                .maxImages(3)
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        try {
            System.out.println("---stream call for image interleave----");
            Flowable<ImageGenerationResult> resultFlowable = imageGeneration.streamCall(param);
            resultFlowable.blockingForEach(result -> {
                System.out.println(JsonUtils.toJson(result));
            });
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
    }

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

響應樣本

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":0,"total_tokens":28,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"辣椒"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":1,"total_tokens":29,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"炒"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":2,"total_tokens":30,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"肉"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":73,"total_tokens":101,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"。"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":198,"total_tokens":226,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":199,"total_tokens":227,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"接下來"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":245,"total_tokens":273,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"。"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":368,"total_tokens":396,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":369,"total_tokens":397,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"最後"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":416,"total_tokens":444,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"鍋"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":417,"total_tokens":445,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"。"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":541,"total_tokens":569,"image_count":3,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"stop","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":true},"status_code":200,"code":"","message":""}

非同步呼叫

請求樣本

注意：非同步呼叫不需要設定stream參數

import com.alibaba.dashscope.aigc.imagegeneration.*;
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.util.Collections;

/**
 * wan2.6-image 圖文輸出 - 非同步呼叫樣本
 */
public class Main {

    static {
        // 以下為新加坡地區url，各地區的base_url不同
        Constants.baseHttpApiUrl = "https://dashscope-intl.aliyuncs.com/api/v1";
    }

    // 若沒有配置環境變數，請用百鍊API Key將下行替換為：apiKey="sk-xxx"
    // 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void asyncCall() throws ApiException, NoApiKeyException, UploadFileException {
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Collections.singletonList(
                        Collections.singletonMap("text", "給我一個3張圖的辣椒炒肉教程")
                )).build();


        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.6-image")
                .size("1280*1280")
                .enableInterleave(true)
                .maxImages(3)
                .negativePrompt("")
                .messages(Collections.singletonList(message))
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        ImageGenerationResult result = null;
        try {
            System.out.println("---async call for image interleave, creating task----");
            result = imageGeneration.asyncCall(param);
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
        System.out.println("任務建立結果:");
        System.out.println(JsonUtils.toJson(result));

        String taskId = result.getOutput().getTaskId();
        // 等待任務完成
        waitTask(taskId);
    }

    public static void waitTask(String taskId) throws ApiException, NoApiKeyException {
        ImageGeneration imageGeneration = new ImageGeneration();
        System.out.println("\n---waiting for task completion----");
        ImageGenerationResult result = imageGeneration.wait(taskId, apiKey);
        System.out.println("任務完成結果:");
        System.out.println(JsonUtils.toJson(result));
    }

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

響應樣本

1、建立任務的響應樣本

{
    "requestId": "7d6c5760-334b-48c4-9b1e-08ee9c7fexxx",
    "output": {
        "task_id": "1bb9d9fa-bf1a-43dc-b5fe-366c1dc70xxx",
        "task_status": "PENDING"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

2、查詢任務結果的響應樣本

{
    "requestId": "6ed62b00-2225-4fc3-8ee3-2aed0b484xxx",
    "usage": {
        "input_tokens": 29,
        "output_tokens": 471,
        "total_tokens": 500,
        "image_count": 3,
        "size": "1280*1280"
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "text": "辣椒炒肉是湘菜中的經典，也是許多人心中的家常美味。它以鮮辣爽口、肉質鮮嫩而聞名，製作過程簡單，卻能帶來極致的味蕾享受。今天，我們就來一起學習這道菜的製作方法。\n\n首先，準備好所有食材是成功的第一步。新鮮的豬肉、紅綠辣椒、蒜瓣和薑片是必不可少的。將豬肉切成薄片，辣椒切段，蒜和薑切片備用。",
                            "type": "text"
                        },
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        },
                        {
                            "text": "接下來是醃制豬肉。將切好的豬肉片放入碗中，加入少許生抽、料酒、澱粉和食用油，用手抓勻，醃制10-15分鐘。這樣處理過的肉片會更加滑嫩入味。",
                            "type": "text"
                        },
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        },
                        {
                            "text": "最後，熱鍋涼油，放入醃制好的肉片快速滑炒至變色，盛出備用。鍋中留底油，放入蒜片和薑片爆香，再加入辣椒段翻炒出香味。隨後倒入肉片，加入生抽、老抽、少許糖和蠔油，快速翻炒均勻，撒上蔥花即可出鍋。",
                            "type": "text"
                        },
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "task_id": "1bb9d9fa-bf1a-43dc-b5fe-366c1dc70836",
        "task_status": "SUCCEEDED",
        "finished": true,
        "submit_time": "2026-01-16 18:26:32.082",
        "scheduled_time": "2026-01-16 18:26:32.133",
        "end_time": "2026-01-16 18:28:41.748"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

使用限制

資料時效：任務task_id和映像url均只保留 24 小時，到期後將無法查詢或下載。
內容審核：輸入的 prompt 和輸出的映像均會經過Alibaba Content Security Service審核，包含違規內容的請求將報錯“IPInfringementSuspect”或“DataInspectionFailed”，具體參見錯誤資訊。

網路訪問配置：映像連結儲存於阿里雲 OSS，如果業務系統因安全性原則無法訪問外部OSS連結，請將以下 OSS 網域名稱加入網路訪問白名單。

# OSS網域名稱列表
dashscope-result-bj.oss-cn-beijing.aliyuncs.com
dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com
dashscope-result-sh.oss-cn-shanghai.aliyuncs.com
dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com
dashscope-result-zjk.oss-cn-zhangjiakou.aliyuncs.com
dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com
dashscope-result-hy.oss-cn-heyuan.aliyuncs.com
dashscope-result-cd.oss-cn-chengdu.aliyuncs.com
dashscope-result-gz.oss-cn-guangzhou.aliyuncs.com
dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com

計費與限流

模型免費額度和計費單價請參見模型價格。
模型限流請參見通義萬相。
計費說明：按成功產生的 映像張數 計費。模型調用失敗或處理錯誤不產生任何費用，也不消耗新人免費額度。

錯誤碼

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

常見問題

Q: 如何查看模型的推理費用和調用量？

A: 詳情請參見賬單查詢與成本管理。

Q：為什麼程式碼範例無法調用？

A：請升級您的SDK版本到最新版，更新請參考安裝SDK。

模型概覽

前提條件

HTTP同步調用

請求參數

影像編輯

圖文混排（僅支援流式）

要求標頭（Headers）

請求體（Request Body）

響應參數

任務執行成功

任務執行成功（流式輸出）

任務執行異常

HTTP非同步呼叫

步驟1：建立任務擷取任務ID

請求參數

影像編輯

圖文混排輸出

要求標頭（Headers）

請求體（Request Body）

響應參數

成功響應

異常響應

步驟2：根據任務ID查詢結果

請求參數

查詢任務結果

要求標頭（Headers）

URL路徑參數（Path parameters）

響應參數

任務執行成功

任務執行異常

DashScope Python SDK調用

影像編輯

同步調用

請求樣本

響應樣本

非同步呼叫

請求樣本

響應樣本

圖文混合輸出

同步調用（僅支援流式）

請求樣本

響應樣本

非同步呼叫

請求樣本

響應樣本

DashScope Java SDK調用

影像編輯

同步調用

請求樣本

響應樣本

非同步呼叫

請求樣本

響應樣本

圖文混合輸出

同步調用（僅支援流式）

請求樣本

響應樣本

非同步呼叫

請求樣本

響應樣本

使用限制

計費與限流

錯誤碼

常見問題