Skip to main content
萬相

萬相-映像產生與編輯2.6 API參考

萬相映像產生模型支援 影像編輯 、 圖文混排輸出 ，滿足多樣化產生與整合需求。

模型概覽

模型名稱

模型簡介

輸出映像規格

wan2.6-image

萬相2.6 image

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

如需純文字產生圖片（文生圖），建議使用wan2.6-t2i 模型（通義萬相-文生圖V2）。

圖片格式：PNG。

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

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

前提條件

您需要已擷取API Key並配置API Key到環境變數。請將範例程式碼中的 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同步調用

一次請求即可獲得結果，流程簡單，推薦大多數情境使用。
  • 新加坡
  • 美國（維吉尼亞）
  • 華北2（北京）
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。X-DashScope-Ssestring（可選）用於啟用流式輸出。
  • 僅當 parameters.enable_interleave=true 時，必須將該欄位設為 enable。
  • 其他情況下可不傳或忽略。
請求體（Request Body）
model string （必選）模型名稱。設定為wan2.6-image。input object （必選）輸入的基本資料。

屬性

messages array （必選）請求內容數組。當前僅支援單輪對話，即傳入一組role、content參數，不支援多輪對話。

屬性

rolestring （必選）訊息的角色。此參數固定設定為user。contentarray （必選）訊息內容數組。

屬性

textstring（必選）正向提示詞用於描述您期望產生的映像內容、風格和構圖。支援中英文，長度不超過2000個字元，每個漢字、字母、數字或符號計為一個字元，超過部分會自動截斷。樣本值：參考這個風格的圖片，產生番茄炒蛋。注意：content數組中，必須且只能包含一個含 text 欄位的對象。imagestring（可選）輸入映像的URL或Base64編碼字串。映像限制：
  • 映像格式：JPEG、JPG、PNG（不支援透明通道）、BMP、WEBP。
  • 映像解析度：映像的寬高範圍均為[240, 8000]像素。
  • 檔案大小：不超過10MB。
映像數量限制：
  • 輸入映像數量與parameters.enable_interleave參數有關。
    • 當enable_interleave=true時（圖文混排輸出），可輸入0~1張映像。
    • 當enable_interleave=false時（影像編輯），必須輸入1~4張映像。
  • 當輸入多張映像時，需在content數組中傳入多個image對象，並按照數組順序定義映像順序。
支援的輸入格式：
  1. 使用公網可訪問URL
    • 支援 HTTP 或 HTTPS 協議。
    • 樣本值：http://wanx.alicdn.com/material/xxx.jpeg。
  2. 傳入 Base 64 編碼映像後的字串
    • 格式：data:{MIME_type};base64,{base64_data}
    • 樣本：data:image/jpeg;base64,GDU7MtCZzEbTbmRZ...（僅示意，實際需傳入完整字串）
    • Base 64 編碼規範請參見映像傳入方式。
parameters object （可選）影像處理參數。

屬性

negative_prompt string （可選）反向提示詞，用於描述不希望在映像中出現的內容，對畫面進行限制。支援中英文，長度不超過500個字元，超出部分將自動截斷。樣本值：低解析度，低畫質，肢體畸形，手指畸形，畫面過飽和，蠟像感，人臉無細節，過度光滑，畫面具有AI感。構圖混亂。文字模糊，扭曲。size string （可選）輸出圖片解析度參數，支援參考輸入圖比例和直接指定兩種方式。當enable_interleave=false（即影像編輯模式）時：
  • 方式一：參考輸入圖比例（推薦） 可選的輸出解析度檔位：1K（預設）、2K。
    • 1K：輸出總像素接近 1280*1280，寬高比與最後一張輸入映像一致。
    • 2K：輸出總像素接近 2048*2048，寬高比與最後一張輸入映像一致。
  • 方式二：指定產生映像的寬高像素值 總像素在 [768768, 20482048] 之間，且寬高比範圍為 [1:4, 4:1]。
    實際輸出映像的像素值為接近指定值的16的倍數。
當enable_interleave=true（即圖文混排輸出模式）時：
  • 方式一：參考輸入圖比例（預設）
    • 若輸入映像總像素 ≤ 1280*1280，輸出總像素和寬高比與輸入映像一致。
    • 若輸入映像總像素 > 12801280，輸出總像素接近 12801280，寬高比與輸入映像一致。
    • 若無輸入映像，則為1280*1280。
  • 方式二：指定產生映像的寬高像素值 總像素在 [768768, 12801280] 之間，且寬高比範圍為 [1:4, 4:1]。
    實際輸出映像的像素值為接近指定值的16的倍數。

常見比例推薦的解析度

  • 1:1：1280*1280
  • 2:3：800*1200
  • 3:2：1200*800
  • 3:4：960*1280
  • 4:3：1280*960
  • 9:16：720*1280
  • 16:9：1280*720
  • 21:9：1344*576
enable_interleave bool （可選）控制生圖模式：
  • false：預設值，表示影像編輯模式（支援多圖輸入及主體一致性產生）。
    • 用途：基於1～4張輸入映像進行編輯、風格遷移或主體一致性產生。
    • 輸入：必須提供至少1張參考映像。
    • 輸出：可產生1至4張結果映像。
  • true ：表示啟用圖文混排輸出模式（僅支援傳入一張映像或不傳映像）。
    • 用途：根據文本描述產生圖文並茂的內容，或進行純文字產生映像（文生圖）。 純文生圖情境建議優先使用wan2.6-t2i 模型（通義萬相-文生圖V2）。
    • 輸入：可以不提供映像（文生圖），或提供最多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，也不能保證每次產生結果完全一致。
  • 影像編輯
  • 圖文混排（僅支援流式）
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": "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": "1K"
    }
}'

響應參數

output object任務輸出資訊。

屬性

choices array of object模型產生的輸出內容。

屬性

finish_reason string任務停止原因。非流式輸出情境：自然停止時為stop。流式輸出情境：當開啟流式輸出時，該參數判斷資料流是否傳輸結束。
  • 傳輸過程中：前序資料包會持續返回 "finish_reason": "null"，表示內容仍在產生中，請繼續接收。
  • 傳輸結束時：僅在最後一個 JSON 結構體中返回 "finish_reason":"stop"，表示流式請求已全部結束，應停止接收。
message object模型返回的訊息。

屬性

rolestring訊息的角色，固定為assistant。contentarray

屬性

type string輸出的類型，枚舉值為text、image。text string產生的文字。image string產生映像的 URL，映像格式為PNG。連結有效期間為24小時，請及時下載並儲存映像。
finished bool請求結束標誌符。
  • true：表示請求結束。
  • false：表示請求未結束。
usage object輸出資訊統計。只對成功的結果計數。

屬性

image_count integer產生映像的張數。size string產生的映像解析度。樣本值：1376*768。input_tokens integer按圖片張數計費。
  • 在影像編輯模式下，固定為0。
  • 在圖文混排模式下，此欄位統計輸入文本的token數量（不計費）。
output_tokens integer按圖片張數計費。
  • 在影像編輯模式下，固定為0。
  • 在圖文混排模式下，此欄位統計輸出文本的token數量（不計費）。
total_tokensinteger按圖片張數計費。
  • 在影像編輯模式下，固定為0。
  • 在圖文混排模式下，此欄位統計總token數量（不計費）。
request_idstring請求唯一標識。可用於請求明細溯源和問題排查。codestring請求失敗的錯誤碼。請求成功時不會返回此參數，詳情請參見錯誤碼。messagestring請求失敗的詳細資料。請求成功時不會返回此參數，詳情請參見錯誤碼。
  • 任務執行成功
  • 任務執行成功（流式輸出）
  • 任務執行異常
任務資料（如任務狀態、映像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": "1376*768",
        "total_tokens": 0
    },
    "request_id": "a3f4befe-cacd-49c9-8298-xxxxxx"
}

HTTP非同步呼叫

流程包含 “建立任務 -> 輪詢擷取” 兩個核心步驟，具體如下：

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

  • 新加坡
  • 美國（維吉尼亞）
  • 華北2（北京）
  • 德國（法蘭克福）
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation調用時請將{WorkspaceId}替換為真實的Workspace ID。
  • 建立成功後，使用介面返回的 task_id 查詢結果，task_id 有效期間為 24 小時。請勿重複建立任務，輪詢擷取即可。
  • 新手指引請參見Postman。

請求參數

要求標頭（Headers）
Content-Typestring（必選）請求內容類型。此參數必須設定為application/json。Authorizationstring（必選）請求身份認證。介面使用阿里雲百鍊API Key進行身份認證。樣本值：Bearer sk-xxxx。X-DashScope-Asyncstring（必選）非同步處理配置參數，必須設定為enable。
缺少此要求標頭將報錯：“current user api does not support synchronous calls”。
請求體（Request Body）
model string （必選）模型名稱。樣本值：wan2.6-imageinput object （必選）輸入的基本資料。

屬性

messages array （必選）請求內容數組。當前僅支援單輪對話，即傳入一組role、content參數，不支援多輪對話。

屬性

rolestring （必選）訊息的角色。此參數固定設定為user。contentarray （必選）訊息內容數組。

屬性

textstring（必選）正向提示詞用於描述您期望產生的映像內容、風格和構圖。支援中英文，長度不超過2000個字元，每個漢字、字母、數字或符號計為一個字元，超過部分會自動截斷。樣本值：參考這個風格的圖片，產生番茄炒蛋。注意：content數組中，必須且只能包含一個含 text 欄位的對象。imagestring（可選）輸入映像的URL或Base64編碼字串。映像限制：
  • 映像格式：JPEG、JPG、PNG（不支援透明通道）、BMP、WEBP。
  • 映像解析度：映像的寬高範圍均為[240, 8000]像素。
  • 檔案大小：不超過10MB。
映像數量限制：
  • 輸入映像數量與parameters.enable_interleave參數有關。
    • 當enable_interleave=true時（圖文混排輸出），可輸入0~1張映像。
    • 當enable_interleave=false時（影像編輯），必須輸入1~4張映像。
  • 當輸入多張映像時，需在content數組中傳入多個image對象，並按照數組順序定義映像順序。
支援的輸入格式：
  1. 使用公網可訪問URL
    • 支援 HTTP 或 HTTPS 協議。
    • 樣本值：http://wanx.alicdn.com/material/xxx.jpeg。
  2. 傳入 Base 64 編碼映像後的字串
    • 格式：data:{MIME_type};base64,{base64_data}
    • 樣本：data:image/jpeg;base64,GDU7MtCZzEbTbmRZ...（僅示意，實際需傳入完整字串）
    • Base 64 編碼規範請參見映像傳入方式。
parameters object （可選）影像處理參數。

屬性

negative_prompt string （可選）反向提示詞，用於描述不希望在映像中出現的內容，對畫面進行限制。支援中英文，長度不超過500個字元，超出部分將自動截斷。樣本值：低解析度，低畫質，肢體畸形，手指畸形，畫面過飽和，蠟像感，人臉無細節，過度光滑，畫面具有AI感。構圖混亂。文字模糊，扭曲。size string （可選）輸出圖片解析度參數，支援參考輸入圖比例和直接指定兩種方式。當enable_interleave=false（即影像編輯模式）時：
  • 方式一：參考輸入圖比例（推薦） 可選的輸出解析度檔位：1K（預設）、2K。
    • 1K：輸出總像素接近 1280*1280，寬高比與最後一張輸入映像一致。
    • 2K：輸出總像素接近 2048*2048，寬高比與最後一張輸入映像一致。
  • 方式二：指定產生映像的寬高像素值 總像素在 [768768, 20482048] 之間，且寬高比範圍為 [1:4, 4:1]。
    實際輸出映像的像素值為接近指定值的16的倍數。
當enable_interleave=true（即圖文混排輸出模式）時：
  • 方式一：參考輸入圖比例（預設）
    • 若輸入映像總像素 ≤ 1280*1280，輸出總像素和寬高比與輸入映像一致。
    • 若輸入映像總像素 > 12801280，輸出總像素接近 12801280，寬高比與輸入映像一致。
    • 若無輸入映像，則為1280*1280。
  • 方式二：指定產生映像的寬高像素值 總像素在 [768768, 12801280] 之間，且寬高比範圍為 [1:4, 4:1]。
    實際輸出映像的像素值為接近指定值的16的倍數。

常見比例推薦的解析度

  • 1:1：1280*1280
  • 2:3：800*1200
  • 3:2：1200*800
  • 3:4：960*1280
  • 4:3：1280*960
  • 9:16：720*1280
  • 16:9：1280*720
  • 21:9：1344*576
enable_interleave bool （可選）控制生圖模式：
  • false：預設值，表示影像編輯模式（支援多圖輸入及主體一致性產生）。
    • 用途：基於1～4張輸入映像進行編輯、風格遷移或主體一致性產生。
    • 輸入：必須提供至少1張參考映像。
    • 輸出：可產生1至4張結果映像。
  • true ：表示啟用圖文混排輸出模式（僅支援傳入一張映像或不傳映像）。
    • 用途：根據文本描述產生圖文並茂的內容，或進行純文字產生映像（文生圖）。 純文生圖情境建議優先使用wan2.6-t2i 模型（通義萬相-文生圖V2）。
    • 輸入：可以不提供映像（文生圖），或提供最多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，也不能保證每次產生結果完全一致。
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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": "1K"
    }
}'

響應參數

output object任務輸出資訊。

屬性

task_id string任務ID。查詢有效期間24小時。task_status string任務狀態。

枚舉值

  • PENDING：任務排隊中
  • RUNNING：任務處理中
  • SUCCEEDED：任務執行成功
  • FAILED：任務執行失敗
  • CANCELED：任務已取消
  • UNKNOWN：任務不存在或狀態未知
request_idstring請求唯一標識。可用於請求明細溯源和問題排查。codestring請求失敗的錯誤碼。請求成功時不會返回此參數，詳情請參見錯誤碼。messagestring請求失敗的詳細資料。請求成功時不會返回此參數，詳情請參見錯誤碼。
  • 成功響應
  • 異常響應
請儲存 task_id，用於查詢任務狀態與結果。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

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

  • 新加坡
  • 美國（維吉尼亞）
  • 華北2（北京）
  • 德國（法蘭克福）
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}調用時請將{WorkspaceId}替換為真實的Workspace ID。
  • 輪詢建議：映像產生過程耗時較長，建議採用輪詢機制，並設定合理的查詢間隔（如 10 秒）來擷取結果。
  • 任務狀態流轉：PENDING（排隊中）→ RUNNING（處理中）→ SUCCEEDED（成功）/ FAILED（失敗）。
  • 結果連結：任務成功後返回映像連結，有效期間為 24 小時。建議在擷取連結後立即下載並轉存至永久儲存（如阿里雲 OSS）。

請求參數

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

響應參數

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模型返回的訊息。

屬性

rolestring訊息的角色，固定為assistant。contentarray

屬性

type string輸出的類型，枚舉值為text、image。text string產生的文字。image string產生映像的 URL，映像格式為PNG。連結有效期間為24小時，請及時下載並儲存映像。
usage object輸出資訊統計。只對成功的結果計數。

屬性

image_count integer產生映像的張數。size string產生的映像解析度。樣本值：1376*768。input_tokens integer輸入token數量。按圖片張數計費，當前固定為0。output_tokens integer輸出token數量。按圖片張數計費，當前固定為0。total_tokensinteger總token數量。按圖片張數計費，當前固定為0。
request_idstring請求唯一標識。可用於請求明細溯源和問題排查。codestring請求失敗的錯誤碼。請求成功時不會返回此參數，詳情請參見錯誤碼。messagestring請求失敗的詳細資料。請求成功時不會返回此參數，詳情請參見錯誤碼。
  • 任務執行成功
  • 任務執行異常
任務資料（如任務狀態、映像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": "1376*768",
        "total_tokens": 0,
        "image_count": 2,
        "output_tokens": 0,
        "input_tokens": 0
    }
}

DashScope Python SDK調用

SDK 的參數命名與HTTP介面基本一致，參數結構根據語言特性進行封裝。 由於任務耗時較長，SDK 在底層封裝了 HTTP 非同步呼叫流程，支援同步、非同步兩種調用方式。
具體耗時受限於排隊任務數和服務執行情況，請在擷取結果時耐心等待。
請確保 DashScope Python SDK 版本不低於1.25.8，再運行以下代碼。更新請參考安裝SDK。
各地區的base_url和 API Key 不通用，以下樣本以新加坡地區為例進行調用：
  • 新加坡
  • 美國（維吉尼亞）
  • 華北2（北京）
  • 德國（法蘭克福）
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1調用時請將{WorkspaceId}替換為真實的Workspace ID。
全球部署範圍（法蘭克福地區）僅支援非同步呼叫。

影像編輯

  • 同步調用
  • 非同步呼叫
請求樣本 
import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.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="1K"
    )

print(rsp)
響應樣本
url 有效期間24小時，請及時下載映像。 
{
    "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": "1376*768",
        "total_tokens": 0
    }
}

圖文混合輸出

  • 同步調用（僅支援流式）
  • 非同步呼叫
請求樣本 
import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.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()
響應樣本
url 有效期間24小時，請及時下載映像。 
{"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"}}

DashScope Java SDK調用

SDK 的參數命名與HTTP介面基本一致，參數結構根據語言特性進行封裝。 由於任務耗時較長，SDK 在底層封裝了 HTTP 非同步呼叫流程，支援同步、非同步兩種調用方式。
具體耗時受限於排隊任務數和服務執行情況，請在擷取結果時耐心等待。
請確保 DashScope Java SDK 版本不低於2.22.6，再運行以下代碼。
各地區的base_url和 API Key 不通用，以下樣本以新加坡地區為例進行調用：
  • 新加坡
  • 美國（維吉尼亞）
  • 華北2（北京）
  • 德國（法蘭克福）
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1調用時請將{WorkspaceId}替換為真實的Workspace ID。
全球部署範圍（法蘭克福地區）僅支援非同步呼叫。

影像編輯

  • 同步調用
  • 非同步呼叫
請求樣本 
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，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.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("1K")
                .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());
        }
    }
}
響應樣本
url 有效期間24小時，請及時下載映像。 
{
    "requestId": "b148327e-830f-414c-a8df-724dec28exxx",
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "total_tokens": 0,
        "image_count": 1,
        "size": "1376*768"
    },
    "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 io.reactivex.Flowable;

import java.util.Collections;

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

    static {
        // 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.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);
    }
}
響應樣本
url 有效期間24小時，請及時下載映像。 
{"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":""}

使用限制

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

計費與限流

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

錯誤碼

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

常見問題

Q：為什麼程式碼範例無法調用？ A：請升級您的SDK版本到最新版，更新請參考安裝SDK。
使用 API
文本產生
映像產生
視頻產生
音頻
即時多模態
Realtime API
  • 概述
向量與排序
更多模型
工具包/架構
模型生產
檔案管理
更多
萬相-映像產生與編輯2.6 API參考 - Alibaba Cloud Model Studio