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

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

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

重要

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

模型與價格

北京地區

模型名稱

計費單價

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

任務下發介面RPS限制

同時處理中任務數量

wan2.2-s2v

480P：$0.071677/秒

720P：$0.129018/秒

點擊查看計費樣本

計費公式為：總費用 = 視頻實際產生時間長度 (秒) × 所選解析度的單價。

假設您產生一個視頻，任務成功後返回的 usage.video_duration 為 10.23秒，且選擇的是 480P 解析度。

費用計算：10.23秒 × $0.071677/秒 = $0.73325571

註：計費時間長度以任務成功後返回的 usage.video_duration 欄位為最終依據。

HTTP調用介面

前提條件

已開通服務並獲得API-KEY：準備工作：配置 API Key。
配置環境變數：配置API Key到環境變數（準備下線，併入配置 API Key）。

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

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

說明

因該模型調用耗時較長，故採用非同步呼叫的方式建立任務。
任務建立後，系統會立即返回一個 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

出參描述

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

請求樣本

curl 'https://dashscope.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。

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

說明

視頻產生任務耗時較長，建議採用輪詢機制，並設定合理的查詢間隔（如 10秒）來擷取結果。
任務成功後返回的 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
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。

curl -X GET https://dashscope.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,
        "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."
    }
}

計費與限流

計費規則

計費項目：按成功產生的 視頻秒數 計費，採用按量後付費模式。
計費公式：費用 = 計費單價 × 視頻時間長度（秒）。
抵扣順序：優先消耗免費額度。額度用盡後，預設轉為隨用隨付。
- 您可開啟“免費額度用完即停”功能，以避免免費額度耗盡後產生額外費用。詳情請參見免費額度。
失敗不計費：模型調用失敗或處理錯誤不產生任何費用，也不消耗免費額度。

免費額度

關於免費額度的領取、查詢、使用方法等詳情，請參見免費額度。

調用量查詢

模型調用完約一小時後，請在模型觀測（新加坡）頁面，查看調用量、調用次數、成功率等指標。

如果使用“華北2（北京）”地區的模型，請前往“華北2（北京）”地區的模型觀測頁面。

限流

模型限流規則及常見問題，請參見限流。

錯誤碼

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