数字人wan2.2-s2v视频生成API参考

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

本文档仅适用于华北2（北京）地域，且必须使用该地域的API Key。

模型与价格

模型名称	计费单价	限流（主账号与RAM子账号共用）	免费额度（查看）
wan2.2-s2v	480P：0.5元/秒 720P：0.9元/秒	5	1	100秒

模型名称

计费单价

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

免费额度（查看）

任务下发接口RPS限制

同时处理中任务数量

wan2.2-s2v

480P：0.5元/秒

720P：0.9元/秒

100秒

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 链接。本地文件可通过上传文件获取临时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

生成视频的时长与输入音频的时长一致，因此单次生成的视频时长同样受音频时长限制（须小于 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小时，请及时下载并保存视频。
此查询接口的默认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
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."
    }
}

计费与限流

模型免费额度和计费单价请参见万相-数字人。
模型限流请参见万相系列。
计费说明：
- 输入不计费，输出计费。按成功生成的视频秒数计费。
- 模型调用失败或处理错误不产生任何费用，也不消耗新人免费额度。

错误码

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

​模型与价格

​HTTP调用接口

​前提条件

​步骤1：创建任务获取任务ID

​入参描述

​出参描述

​请求示例

​响应示例

​步骤2：根据任务ID查询结果

​入参描述

​出参描述

​请求示例

​响应示例

​计费与限流

​错误码

模型与价格

HTTP调用接口

前提条件

步骤1：创建任务获取任务ID

入参描述

出参描述

请求示例

响应示例

步骤2：根据任务ID查询结果

入参描述

出参描述

请求示例

响应示例

计费与限流

错误码