动作迁移与视频换人

基于一张人物图片和一段参考视频，实现「动作迁移」或「视频换人」（wan2.2-animate 系列）。

备注

本页型号暂未上架，以模型广场为准。

模型能力

模型	能力	适用场景
`wan2.2-animate-move`	动作迁移：将参考视频中的动作和表情迁移到图片人物上	舞蹈复刻、肢体动作复刻、影视表演复刻
`wan2.2-animate-mix`	视频换人：将视频中的主角替换为图片中的角色，保留原视频的场景、光照、色调、动作与表情	二次创作、影视后期等角色替换场景

两个模型共用同一提交端点，通过 model 区分；均提供两种服务模式（parameters.mode）：

模式	说明
`wan-std` 标准模式	生成速度快、费用低，适合快速预览和基础动画
`wan-pro` 专业模式	动画更流畅、画质更好，处理时间和费用相应增加

创建任务

POST https://platform.shuyanai.com/ali/api/v1/services/aigc/image2video/video-synthesis

请求头

参数	类型	必填	说明
`Content-Type`	string	是	`application/json`
`Authorization`	string	是	`Bearer sk-xxx`

官方要求的 X-DashScope-Async: enable 头由平台自动补充，无需携带。

请求体

参数	类型	必填	默认值	说明
`model`	string	是		`wan2.2-animate-move`（动作迁移）或 `wan2.2-animate-mix`（视频换人）
`input`	object	是		输入参数
`input.image_url`	string	是		人物图片的公网 HTTP/HTTPS URL。URL 含中文等非 ASCII 字符时须先做 URL 编码
`input.video_url`	string	是		参考视频的公网 HTTP/HTTPS URL，同样须 URL 编码。建议使用高分辨率、高帧率的参考视频
`input.watermark`	boolean	否	false	是否在视频右下角添加 AI 生成水印
`parameters`	object	是		参数对象
`parameters.mode`	string	是		服务模式：`wan-std`（标准）/ `wan-pro`（专业），差异见上方模式表
`parameters.check_image`	boolean	否	true	是否在处理前检测输入图片。`false` 跳过检测直接处理

输入素材要求

move / mix 两个模型要求相同：

项目	图片 `image_url`	视频 `video_url`
格式	JPG、JPEG、PNG、BMP、WEBP	MP4、AVI、MOV
尺寸	宽高均在 [200, 4096] 像素，宽高比 1:3 ~ 3:1	宽高均在 [200, 2048] 像素，宽高比 1:3 ~ 3:1
大小	不超过 5 MB	不超过 200 MB
时长	—	2 ~ 30 秒

效果建议：

输入图片与参考视频中的人物画幅占比相近；

图片和视频中人物的身材比例一致；

使用高清素材，避免模糊图片和低帧率视频。

请求示例

动作迁移（标准模式）

视频换人（专业模式）

响应示例

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

字段	类型	说明
`output.task_id`	string	任务 ID，用于查询，有效期 24 小时
`output.task_status`	string	任务状态，创建成功时为 `PENDING`
`request_id`	string	请求唯一标识，用于问题排查

结果与用量

任务成功后，查询结果中的视频地址位于 output.results.video_url（MP4，H.264 编码，有效期 24 小时），usage 字段为计费依据：

{
  "output": {
    "task_status": "SUCCEEDED",
    "results": {
      "video_url": "https://xxx.mp4?Expires=xxx"
    }
  },
  "usage": {
    "video_duration": 5.2,
    "video_ratio": "standard"
  }
}

字段	类型	说明
`usage.video_duration`	float	本次生成的视频时长，单位：秒
`usage.video_ratio`	string	服务模式：`standard`（对应 `wan-std`）/ `pro`（对应 `wan-pro`）

按输出视频秒数计费，专业模式单价高于标准模式，单价以模型广场为准。

查询任务

创建任务后，用 task_id 轮询任务状态及结果：

GET https://platform.shuyanai.com/ali/api/v1/tasks/{task_id}

响应结构、任务状态与轮询建议见 09-查询任务。

06-动作迁移与视频换人

动作迁移与视频换人#

模型能力#

创建任务#

请求头#

请求体#

输入素材要求#

请求示例#

响应示例#

结果与用量#

查询任务#

动作迁移与视频换人

模型能力

创建任务

请求头

请求体

输入素材要求

请求示例

响应示例

结果与用量

查询任务