万相-视频换人

POST /api/v1/services/aigc/image2video/video-synthesis — wan2.2-animate-mix 角色替换

万相视频换人模型（wan2.2-animate-mix）：依据人物图片和参考视频，把视频中的主角替换为图片中的角色，保留原视频的动作、场景、光照和色调。

支持的模型

模型	说明
`wan2.2-animate-mix`	视频换人，`wan-std`（标准）/ `wan-pro`（专业）两种服务模式

创建任务

POST/api/v1/services/aigc/image2video/video-synthesis

curl https://api.modelsite.ai/api/v1/services/aigc/image2video/video-synthesis \
  -H "Authorization: Bearer $MODELSITE_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.2-animate-mix",
    "input": {
      "image_url": "https://example.com/character.jpeg",
      "video_url": "https://example.com/reference.mp4",
      "watermark": false
    },
    "parameters": { "mode": "wan-std" }
  }'

请求体

字段	类型	说明
`model`	string（必填）	固定为 `wan2.2-animate-mix`
`input.image_url`	string（必填）	人物图片 URL。JPG/JPEG/PNG/BMP/WEBP，宽高 [200, 4096]px，宽高比 1:3~3:1，≤5MB
`input.video_url`	string（必填）	参考视频 URL。MP4/AVI/MOV，宽高 [200, 2048]px，宽高比 1:3~~3:1，≤200MB，时长 2~~30 秒
`input.watermark`	boolean（可选）	水印（右下角 "通义AI生成"）。默认 `false`。注意：在 `input` 里，不在 `parameters` 里
`parameters.mode`	string（必填）	`wan-std` 标准模式（快、性价比高）/ `wan-pro` 专业模式（更流畅、更优画质，费用更高）
`parameters.check_image`	boolean（可选）	处理前是否检查输入图片，默认 `true`

这个模型没有 prompt、media、duration、resolution——人物图 + 参考视频即完整输入，输出规格跟随参考视频。传了 media 数组会被拒绝。

轮询与结果

GET/api/v1/tasks/{task_id}

curl "https://api.modelsite.ai/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $MODELSITE_API_KEY"

响应字段

字段	说明
`output.task_id`	任务 ID（与创建时返回的一致）
`output.task_status`	`PENDING` 排队 / `RUNNING` 处理中 / `SUCCEEDED` 成功 / `FAILED` 失败
`output.video_url`	生成视频的 URL，仅 `SUCCEEDED` 时返回，尽快下载转存
`output.code` / `output.message`	仅失败时返回，失败原因
`usage`	用量统计（时长、分辨率档位等），仅成功时计数
`request_id`	请求唯一标识，排查问题时请提供

状态流转：PENDING → RUNNING → SUCCEEDED / FAILED。

这个模型有两点差异：成功时视频地址在 output.results.video_url（不在 output.video_url）；usage.video_duration 是计费时长（浮点秒），usage.video_ratio 回显服务模式（standard / pro）。

计费

按实际生成时长（浮点秒）计费，wan-std 与 wan-pro 单价不同；任务失败不计费。单价见模型页。

错误处理

创建阶段错误返回 {"code": "...", "message": "..."}（如缺 parameters.mode）；任务内失败看轮询的 output.code / output.message。通用错误码见错误处理。

万相-视频换人

支持的模型

创建任务

轮询与结果

计费

错误处理

本页内容