Maas-Model-platform/docs/outside/bailian/数字人合成API.md

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

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

功能特点

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

模型与价格

模型名称	计费单价	任务下发RPS限制	同时处理中任务数量
wan2.2-s2v	480P: ¥0.5/秒, 720P: ¥0.9/秒	5	1

计费公式: 总费用 = 视频实际生成时长(秒) × 所选分辨率的单价

HTTP调用接口

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

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

请求头

字段	类型	必选	描述
Content-Type	String	是	application/json
Authorization	String	是	Bearer sk-xxx
X-DashScope-Async	String	是	固定值为 enable

请求体

字段	类型	必选	描述
model	String	是	wan2.2-s2v
input.image_url	String	是	图片URL,支持jpg/jpeg/png/bmp/webp,分辨率[400,7000]像素
input.audio_url	String	是	音频URL,支持wav/mp3,文件<15M,时长<20s
parameters.resolution	String	否	480P(默认)或720P

响应

字段	类型	描述
output.task_id	String	异步任务的唯一ID
output.task_status	String	任务状态: PENDING
request_id	String	请求ID

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

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

请求头

字段	类型	必选	描述
Authorization	String	是	Bearer sk-xxx

响应

字段	类型	描述
output.task_id	String	任务ID
output.task_status	String	PENDING/RUNNING/SUCCEEDED/FAILED/UNKNOWN/CANCELED
output.submit_time	String	任务提交时间
output.scheduled_time	String	任务执行时间
output.end_time	String	任务完成时间
output.results.video_url	String	生成的视频URL(注意是results.video_url)
output.code	String	错误码(失败时)
output.message	String	错误详情(失败时)
usage.duration	Float	视频时长(秒),用于计费(注意是duration不是video_duration)
usage.video_count	Integer	生成视频数量
usage.SR	Integer	分辨率档位
request_id	String	请求ID

成功响应示例

{
  "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."
  }
}

重要注意事项

1. 视频URL路径: 成功时视频URL在 output.results.video_url 而非 output.video_url
2. 计费时长字段: 使用 usage.duration 而非 usage.video_duration
3. 轮询间隔: 建议10秒查询一次
4. URL有效期: video_url有效期为24小时,请及时下载保存
5. task_id有效期: 仅支持24小时内查询