通义万相wan2.2-s2v数字人对口型视频生成API参考_大模型服务平台百炼(Model Studio)-阿里云帮助中心

数字人wan2.2-s2v模型能基于单张图片和音频，生成动作自然的说话、唱歌或表演视频。

音频驱动: 通过输入的人声音频，驱动静态图片中的人物实现口型、表情和动作与音频同步。
场景丰富: 支持 "说话"、"唱歌" 、“表演”三种对口型场景
人物形象多样化：支持真人（肖像、半身、全身）及卡通人物。
输出视频分辨率：提供480P、720P两档分辨率选项。

模型与价格

模型名称

计费单价

限流（主账号与RAM子账号共用）

免费额度（查看）

任务下发接口RPS限制

同时处理中任务数量

wan2.2-s2v

480P：0.5元/秒

720P：0.9元/秒

100秒

点击查看计费示例

费用在免费额度耗尽后开始计算。计费公式为：总费用 = 视频实际生成时长 (秒) × 所选分辨率的单价。

假设您生成一个视频，任务成功后返回的 usage.video_duration 为 10.23秒，且选择的是 480P 分辨率。

费用计算：10.23秒 × 0.5元/秒 = 5.115元

注：计费时长以任务成功后返回的 usage.video_duration 字段为最终依据。

HTTP调用接口

前提条件

已开通服务并获得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 链接。本地文件请参见上传文件获取临时URL。	http://aaa/bbb.jpg
input.audio_url	String	Body	是	上传的音频文件 URL。音频格式：格式为wav、mp3。音频限制：文件<15M，时长＜20s。音频内容：音频中需包含清晰、响亮的人声语音，并去除了环境噪音、背景音乐等声音干扰信息。上传音频仅支持公网可访问的 HTTP/HTTPS 链接。本地文件请参见上传文件获取临时URL。	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小时，请及时下载并保存视频。
此查询接口的默认QPS为20。如需更高频次的查询或事件通知，请配置异步任务回调。
如需批量查询或取消任务，请参见管理异步任务。

入参描述

字段	类型	传参方式	必选	描述	示例值
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."
    }
}

计费与限流

计费规则

计费项：按成功生成的 视频秒数 计费，采用按量后付费模式。
计费公式：费用 = 计费单价 × 视频时长（秒）。
抵扣顺序：优先消耗免费额度。额度用尽后，默认转为按量付费。
- 您可开启“免费额度用完即停”功能，以避免免费额度耗尽后产生额外费用。详情请参见免费额度。
失败不计费：模型调用失败或处理错误不产生任何费用，也不消耗免费额度。

免费额度

关于免费额度的领取、查询、使用方法等详情，请参见免费额度。

调用量查询

模型调用完约一小时后，请在模型观测页面，查看调用量、调用次数、成功率等指标。

限流

模型限流规则及常见问题，请参见限流。

错误码

如果模型调用失败并返回报错信息，请参见错误信息进行解决。