萬相wan2.2-s2v數字人對口型視頻產生API參考 - Alibaba Cloud Model Studio

數字人wan2.2-s2v模型能基於單張圖片和音頻，產生動作自然的說話、唱歌或表演視頻。

音頻驅動: 通過輸入的人聲音頻，驅動靜態圖片中的人物實現口型、表情和動作與音頻同步。
情境豐富: 支援 "說話"、"唱歌" 、“表演”三種對口型情境
人物形象多樣化：支援真人（肖像、半身、全身）及卡通人物。
輸出視頻解析度：提供480P、720P兩檔解析度選項。

重要本文檔僅適用於華北2（北京）地區。如需使用模型，需使用華北2（北京）地區的API Key。

模型與價格

模型名稱	計費單價	限流（主帳號與RAM子帳號共用）
wan2.2-s2v	480P：$0.071677/秒 720P：$0.129018/秒	5	1

模型名稱

計費單價

限流（主帳號與RAM子帳號共用）

任務下發介面RPS限制

同時處理中任務數量

wan2.2-s2v

480P：$0.071677/秒

720P：$0.129018/秒

HTTP調用介面

前提條件

已開通服務並獲得API-KEY：擷取與配置 API Key。
配置環境變數：配置API Key到環境變數。

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

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

調用時請將{WorkspaceId}替換為真實的業務空間ID。

說明

因該模型調用耗時較長，故採用非同步呼叫的方式建立任務。
任務建立後，系統會立即返回一個 task_id。在下一步中，您需要使用此 task_id 在24小時內查詢任務結果。

入參描述

欄位	類型	傳參方式	必選	描述	樣本值
Content-Type	String	Header	是	請求類型：application/json。	application/json
Authorization	String	Header	是	API-Key，格式為 Bearer sk-xxx。	Bearer sk-1a**2b
X-DashScope-Async	String	Header	是	固定值為 enable，表示使用非同步呼叫方式。	enable
model	String	Body	是	指明需要調用的模型。	wan2.2-s2v
input.image_url	String	Body	是	上傳的圖片 URL。映像格式：支援jpg，jpeg，png，bmp，webp。映像解析度：映像的寬度和高度範圍為[400, 7000]像素。上傳圖片僅支援公網可訪問的 HTTP/HTTPS 連結。	http://aaa/bbb.jpg
input.audio_url	String	Body	是	上傳的音頻檔案 URL。音頻格式：格式為wav、mp3。音頻限制：檔案<15M，時間長度＜20s。音頻內容：音頻中需包含清晰、響亮的人聲語音，並去除了環境噪音、背景音樂等聲音幹擾資訊。上傳音頻僅支援公網可訪問的 HTTP/HTTPS 連結。	http://aaa/bbb.mp3
parameters.resolution	String	Body	否	視頻解析度檔位。可選值為480P、720P。預設值為480P。模型會盡量保持輸出視頻與輸入映像的寬高比一致，在寬高比不變的基礎上，將視頻總像素調整到所選檔位附近。樣本 480P：視頻解析度通常指 640×480（約 31萬像素），視頻寬高比為4:3。 720P：視頻解析度通常指 1280×720（約 92萬像素），視頻寬高比為16:9。樣本：若輸入映像的寬高比例為 4:5，且選擇 480P 檔位，則輸出視頻的寬高比會保持4:5，解析度調整為接近 31萬像素。例如，輸出視頻的解析度為 480×600，總像素 28.8萬（此資料僅做參考，以實際輸出為準）。	480P

說明產生視頻的時間長度與輸入音訊時間長度一致，因此單次產生的視頻時間長度同樣受音頻時間長度限制（須小於 20 秒）；若輸入音頻超過 20 秒，會導致任務報錯。如需產生更長的視頻，可將長音頻按小於 20 秒切分為多段，分別調用本介面產生對應的視頻片段，再使用剪輯工具將多段視頻拼接合并為一個完整的長視頻。

出參描述

欄位	類型	描述	樣本值
output.task_id	String	非同步任務的唯一ID。	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	提交非同步任務後的作業狀態。	PENDING
request_id	String	本次請求的唯一ID。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

請求樣本

調用時請將{WorkspaceId}替換為真實的業務空間ID。

curl 'https://{WorkspaceId}.cn-beijing.maas.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-s2v",
     "input": {
            "image_url": "https://img.alicdn.com/imgextra/i3/O1CN011FObkp1T7Ttowoq4F_!!6000000002335-0-tps-1440-1797.jpg",
            "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250825/iaqpio/input_audio.MP3"
        },
        "parameters": {
            "resolution": "480P"
        }
    }'

響應樣本

{
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "PENDING"
    }
    "request_id": "7574ee8f-38a3-4b1e-9280-xxxxxx"
}

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

使用上一步擷取的 task_id，發送 GET 請求查詢任務狀態和結果。請將 URL 中的{task_id} 替換為您的實際任務ID，並將{WorkspaceId}替換為真實的業務空間ID。

GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}

說明

視頻產生任務耗時較長（約5-10分鐘），建議採用輪詢機制，並設定合理的查詢間隔（如 15秒）來擷取結果。
任務成功後返回的 video_url有效期間為24小時，請及時下載並儲存視頻。

入參描述

欄位	類型	傳參方式	必選	描述	樣本值
Authorization	String	Header	是	API-Key，例如：Bearer sk-xxx。	Bearer sk-xxx
task_id	String	Url Path	是	需要查詢任務的ID。	a8532587-fa8c-4ef8-82be-0c46b17950d1

出參描述

欄位	類型	描述	樣本值
output.task_id	String	查詢的任務ID。	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	任務狀態。可能的值包括： PENDING 排隊中 RUNNING 處理中 SUCCEEDED 成功 FAILED 失敗 UNKNOWN 作業不存在或狀態未知 CANCELED：任務取消成功	SUCCEEDED
output.submit_time	String	任務提交時間。	2025-09-01 09:37:27.468
output.scheduled_time	String	任務執行時間。	2025-09-01 09:37:34.885
output.end_time	String	任務完成時間。	2025-09-01 09:40:20.734
output.results.video_url	String	產生的視頻檔案。 video_url有效期間為24小時，請及時下載。	https://xxx/1.mp4?Expires=xxx
usage.duration	Float	視頻時間長度（秒），用於計費，按秒計費。	10.23
usage.video_count	Integer	產生視頻的數量。	1
usage.SR	Integer	產生視頻解析度檔位。	480
usage.size	String	本次請求產生視頻的解析度	"size": "640*480"
usage.fps	Integer	本次請求產生視頻的幀率	"fps": 16
output.code	String	錯誤碼。任務失敗時返回此參數。	InvalidParameter
output.message	String	錯誤詳情。任務失敗時返回此參數。	The request is missing required parameters or in a wrong format
request_id	String	本次請求的唯一ID。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

請求樣本

將86ecf553-d340-4e21-xxxxxxxxx替換為真實的task_id，將{WorkspaceId}替換為真實的業務空間ID。

curl -X GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

說明task_id 僅支援在24小時內查詢任務結果，逾時會被系統自動清除。

響應樣本

成功響應

任務資料（如任務狀態、視頻URL等）僅保留24小時，逾時後自動清除，請及時儲存結果。

{
    "output": {
        "task_id": "bcae8761-f242-4775-a11e-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-01 09:37:27.468",
        "scheduled_time": "2025-09-01 09:37:34.885",
        "end_time": "2025-09-01 09:40:20.734",
        "results": {
            "video_url": "http://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/1d/xxx.mp4?Expires=xxxxxx"
        }
    },
    "usage": {
        "duration": 18.13,
        "size": "512*640",
        "fps": 16,
        "video_count": 1,
        "SR": 480
    },
    "request_id": "28cfedb1-cd60-9e0c-b920-xxxxxx"
}

失敗響應

{
    "request_id": "8d49f522-f6a4-9eed-b322-xxxxxx",
    "output": {
        "task_id": "101ad32f-7653-4ae9-8f22-xxxxxx",
        "task_status": "FAILED",
        "submit_time": "2025-09-01 11:43:41.174",
        "scheduled_time": "2025-09-01 11:43:48.937",
        "end_time": "2025-09-01 11:43:49.802",
        "code": "InvalidURL",
        "message": "Required URL is missing or invalid, please check the request URL."
    }
}

計費與限流

模型免費額度和計費單價請參見萬相-數字人。
模型限流請參見萬相系列。
計費說明：
- 輸入不計費，輸出計費。按成功產生的視頻秒數計費。
- 模型調用失敗或處理錯誤不產生任何費用，也不消耗新人免費額度。

錯誤碼

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