效果樣本
萬相-視頻換人模型wan2.2-animate-mix提供標準模式wan-std和專業模式wan-pro兩種服務模式，不同模式在效果和計費上存在差異，詳情參見計費與限流。
人物圖片 | 參考視頻 | 輸出視頻（標準模式wan-std） | 輸出視頻（專業模式wan-pro） |
| | | |
HTTP調用
您需要已擷取API Key並配置API Key到環境變數（準備下線，併入配置 API Key）。請將範例程式碼中的 DASHSCOPE_API_HOST 替換為擷取的 API Host。
重要 北京和新加坡地區擁有獨立的 API Key 與請求地址，不可混用，跨地區調用將導致鑒權失敗或服務報錯。
由於視頻產生耗時較長，HTTP API 採用非同步模式，調用流程分兩步：
建立任務擷取任務ID：發送一個請求建立任務，該請求會返回任務ID（task_id）。
根據任務ID查詢結果：使用task_id輪詢任務狀態，直到任務完成並獲得視頻URL。
步驟1：建立任務擷取任務ID
新加坡地區：POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis
北京地區：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis
請求參數 | 視頻換人以下為新加坡地區base_url，若使用北京地區的模型，需將base_url替換為：https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.2-animate-mix",
"input": {
"image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/bhkfor/mix_input_image.jpeg",
"video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/wqefue/mix_input_video.mp4",
"watermark": true
},
"parameters": {
"mode": "wan-std"
}
}'
|
要求標頭（Headers） |
Content-Type string （必選） 請求內容類型。此參數必須設定為application/json。 |
Authorization string（必選） 請求身份認證。介面使用阿里雲百鍊API-Key進行身份認證。樣本值：Bearer sk-xxxx。 |
X-DashScope-Async string （必選） 非同步處理配置參數。HTTP請求只支援非同步，必須設定為enable。
重要 缺少此要求標頭將報錯：“current user api does not support synchronous calls”。 |
請求體（Request Body） |
model string （必選） 模型名稱，必須設定為wan2.2-animate-mix。 |
input object （必選） 輸入參數對象，包含以下欄位： 屬性 image_url string （必選） 輸入映像的公網可訪問的HTTP/HTTPS連結，不能包含中文等非ASCII字元，否則需要進行編碼後再傳入。 格式限制：JPG、JPEG、PNG、BMP、WEBP 尺寸限制：映像的寬度和高度都在[200,4096]像素範圍內，寬高比在1:3至3:1範圍內。 大小限制：不超過5MB 樣本：https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/bhkfor/mix_input_image.jpeg
video_url string （必選） 輸入視頻的公網可訪問的HTTP/HTTPS連結，不能包含中文等非ASCII字元，否則需要進行編碼後再傳入。 建議：提高參考視頻的解析度和幀率，可有效提升產生視頻的畫質效果。 格式限制：MP4、AVI、MOV 尺寸限制：視頻的寬度和高度都在[200, 2048]像素範圍內，寬高比在1:3至3:1範圍內。 大小限制：不超過200MB 時間長度限制：不小於2s且不大於30s 樣本：https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/wqefue/mix_input_video.mp4
watermark bool （可選） 是否添加浮水印標識，浮水印位於圖片右下角，文案為“通義AI產生”。 false（預設值）：不添加浮水印。
true：添加浮水印。
|
parameters object （必選） 屬性 check_image bool （可選） 是否進行映像檢測。 mode string （必選） 模型服務模式選擇，支援兩種模式。 詳情請參見效果樣本和計費與限流。 |
響應參數 | 成功響應請儲存 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 請求唯一標識。可用於請求明細溯源和問題排查。 |
message string 請求失敗的詳細資料。請求成功時不會返回此參數，詳情請參見錯誤資訊。 | |
code string 請求失敗的錯誤碼。請求成功時不會返回此參數，詳情請參見錯誤資訊。 | |
步驟2：根據任務ID查詢結果
新加坡地區：GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id}
北京地區：GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
說明 輪詢建議：視頻產生過程約需數分鐘，建議採用輪詢機制，並設定合理的查詢間隔（如 15 秒）來擷取結果。
任務狀態流轉：PENDING（排隊中）→ RUNNING（處理中）→ SUCCEEDED（成功）/ FAILED（失敗）。
結果連結：任務成功後返回視頻連結，有效期間為 24 小時。建議在擷取連結後立即下載並轉存至永久儲存（如阿里雲 OSS）。
task_id 有效期間：24小時，逾時後將無法查詢結果，介面將返回任務狀態為UNKNOWN。
請求參數 | 查詢任務結果請將0385dc79-5ff8-4d82-bcb6-xxxxxx替換為真實的task_id。 以下為新加坡地區base_url ，若使用北京地區的模型，需將base_url替換為：https://dashscope.aliyuncs.com/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
|
要求標頭（Headers） |
Authorization string（必選） 請求身份認證。介面使用阿里雲百鍊API-Key進行身份認證。樣本值：Bearer sk-xxxx。 |
URL路徑參數（Path parameters） |
|
響應參數 | 任務執行成功視頻URL僅保留24小時，逾時後會被自動清除，請及時儲存產生的視頻。 {
"request_id": "a67f8716-18ef-447c-a286-xxxxxx",
"output": {
"task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
"task_status": "SUCCEEDED",
"submit_time": "2025-09-18 15:32:00.105",
"scheduled_time": "2025-09-18 15:32:15.066",
"end_time": "2025-09-18 15:34:41.898",
"results": {
"video_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx"
}
},
"usage": {
"video_duration": 5.2,
"video_ratio": "standard"
}
}
任務執行失敗若任務執行失敗，task_status將置為 FAILED，並提供錯誤碼和資訊。請參見錯誤資訊進行解決。 {
"request_id": "daad9007-6acd-9fb3-a6bc-xxxxxx",
"output": {
"task_id": "fe8aa114-d9f1-4f76-b598-xxxxxx",
"task_status": "FAILED",
"code": "InternalError",
"message": "xxxxxx"
}
}
|
output object 任務輸出資訊。 屬性 task_id string 任務ID。查詢有效期間24小時。 task_status string 任務狀態。 枚舉值 PENDING：任務排隊中 RUNNING：任務處理中 SUCCEEDED：任務執行成功 FAILED：任務執行失敗 CANCELED：任務已取消 UNKNOWN：任務不存在或狀態未知
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。 results object 屬性 video_url string 視頻URL。僅在 task_status 為 SUCCEEDED 時返回。 連結有效期間24小時，可通過此URL下載視頻。視頻格式為MP4（H.264 編碼）。 code string 請求失敗的錯誤碼。請求成功時不會返回此參數，詳情請參見錯誤資訊。 message string 請求失敗的詳細資料。請求成功時不會返回此參數，詳情請參見錯誤資訊。 |
usage object 輸出資訊統計。只對成功的結果計數。 屬性 video_duration float 本次請求產生視頻時間長度計量，單位：秒。 video_ratio string 本次請求視頻服務模式選擇，枚舉值： standard，pro。 若選擇標準模式wan-std為standard，選擇專業模式wan-pro則為pro。 |
request_id string 請求唯一標識。可用於請求明細溯源和問題排查。 |
使用限制
資料時效：任務task_id和視頻URL均只保留 24 小時，到期後將無法查詢或下載，請及時下載視頻到本地。
內容審核：輸入與輸出內容均會經過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: 可參考以下建議
確保輸入圖片與參考視頻中的人物畫幅佔比相似。
盡量保持圖片和視頻中人物的身材比例一致。
使用高清素材，避免使用模糊圖片和低幀率視頻，確保細節識別準確。
Q: 如何將臨時的視頻連結轉為永久連結？
A: 不能直接轉換該連結。正確的做法是：後端服務擷取到url後，通過代碼下載該視頻檔案，然後將其上傳到永久Object Storage Service服務（如阿里雲 OSS），產生一個新的、永久訪問連結。
範例程式碼：下載視頻到本地
import requests
def download_and_save_video(video_url, save_path):
try:
response = requests.get(video_url, stream=True, timeout=300) # 設定逾時
response.raise_for_status() # 如果HTTP狀態代碼不是200，則引發異常
with open(save_path, 'wb') as f:
for chunk in response.iter_content(chunk_size=8192):
f.write(chunk)
print(f"視頻已成功下載到: {save_path}")
# 此處可以接上傳到永久儲存的邏輯
except requests.exceptions.RequestException as e:
print(f"下載視頻失敗: {e}")
if __name__ == '__main__':
video_url = "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxxx"
save_path = "video.mp4"
download_and_save_video(video_url, save_path)
Q: 返回的視頻連結可以在瀏覽器中直接播放嗎？
A: 不建議這樣做，因為連結會在 24 小時後失效。最佳實務是後端下載轉存後，使用永久連結進行視頻播放。