Wan Animate Replace API

alibaba/wan/v2.2-14b/animate/replace

Wan Animate Replace 将源视频中的原始人物替换为参考图中的目标角色,支持逼真无缝的角色换人、自然边缘融合与多档高清分辨率。它在严密保留原视频运镜轨迹、环境光影投射与真实物理交互的同时,精准重塑目标角色的面部五官轮廓与服饰外观。

输入

拖拽文件、粘贴剪贴板素材,或输入 URL。 一张图片。页面上传支持 JPG、PNG、WebP,最大 10 MiB;API 接受 HTTP(S) URL 数组。

1/1 个素材

拖拽文件、粘贴剪贴板素材,或输入 URL。 一个视频。页面上传支持 MP4、MOV、MKV,最大 100 MiB;按源视频时长向上取整到秒计费。

1/1 个素材

输出已就绪
预计: 480p · 3 秒 × 7 积分 = 21 积分 ($0.105)

示例

玻璃温室跟拍

柴火灶颠锅

海岸皮划艇划桨

Wan Animate Replace

Wan Animate Replace 是阿里研发的深度视频级角色置换与换人模型。用户只需提供一段包含人物演出的源视频,以及一张目标角色的静态图片,模型即可精准识别原片人物并替换为全新角色。基于 14B 参数多模态骨干网络与时空扩散注意力机制,模型能够自适应原视频的运镜轨迹、动态光影明暗与物理遮挡关系,无需人工逐帧抠像即可完成影视级角色置换。

为什么选择 Wan Animate Replace?

  • 高保真角色与演员置换将实拍视频中的演员一键置换为虚拟数字人、二次元角色或目标形象,面容五官与动作节拍自然贴合。

  • 机位运镜与背景深度锁定严密锁定源视频中的推拉摇移、镜头变焦与复杂背景环境,画面非角色区域保持像素级稳定无抖动。

  • 自然环境光影与物理遮挡融合根据源片光照方向与色彩投射真实反光与动态阴影,准确处理前景道具与身体各部位的复杂遮挡。

  • 多档实用高清画质支持支持 480p 快速分镜预览、580p 社媒制作与 720p 商业级高清成片,灵活适配各类视频制作场景。

参数说明

参数要求说明
image_urls必填

必须为数组,恰好包含一个公开可访问的 HTTP(S) 图片 URL;不接受单个字符串或 Base64。

video_url必填

必填,公开可访问的 HTTP(S) 源视频 URL。Vidgo 最多读取 100 MiB,时长必须大于零;不提交 duration 字段。

resolution可选

仅支持 480p、580p、720p;仅省略时默认为 480p。不接受 null、空字符串、别名或前后空格。

默认值480p580p720p

如何使用 Wan Animate Replace

  1. 提供源视频与替换角色图准备一段包含待替换人物的源视频链接(最高 100 MiB),以及一张目标人物或虚拟形象的静态肖像图片(JPG/PNG/WebP,最高 10 MiB)。

  2. 选择成片分辨率根据交付规格选择 480p(默认)、580p 或 720p 分辨率档位。

  3. 发起角色替换任务通过 API 提交包含 model 与 input 的 POST 请求,或在上方在线体验区直接点击运行发起任务。

  4. 获取并下载置换视频轮询任务状态接口至 finished 阶段,从 data.files[].file_url 获取渲染完成的高保真 MP4 视频成片。

计费说明

预计积分 = 向上取整后的源视频秒数 × 分辨率单价,最终以服务端探测时长为准。例如 480p、5.1 秒按 6 秒计费,共 42 积分($0.210)。视频探测失败不扣费,生成失败退还积分。

计费项费率说明
Replace 480p7 积分/秒 · $0.035/秒按源视频时长向上取整到秒计费。
Replace 580p12 积分/秒 · $0.060/秒按源视频时长向上取整到秒计费。
Replace 720p15 积分/秒 · $0.075/秒按源视频时长向上取整到秒计费。

适用场景

  • 多地域本地化商业广告制作在保留原有广告片置景、运镜与拍摄光影的前提下,为不同国家和地区替换匹配当地受众面孔的演员形象。

  • 影视剧集虚拟替身与选角预览在现有实拍特技镜头或测试样片中快速替换为目标主演面孔,直观评估选角形象与镜头契合度。

  • 游戏与动漫 IP 角色跨次元实景互动将游戏主角、品牌动漫吉祥物或虚拟主播置换进真实生活视频中,制作具有实景光影互动的跨次元短片。

  • 个性化粉丝互动与短视频定制允许创作者或品牌粉丝将经典名场面中的人物置换为专属数字形象,打造高粘性的社交互动玩法。

Wan Animate Replace 创作技巧

  • 保持角色朝向与原片主体大体一致:提供的目标肖像图头部朝向与视角,尽量与原片中人物主要角度接近,可大幅提升五官置换精度。
  • 选用主体与背景边缘分明的源片:原片主体人物轮廓清晰、边缘无重度运动模糊的视频,能有效消除替换边缘的羽化光晕或杂色残留。
  • 先用 480p 验证角色契合度:使用 480p 档位(7 积分/秒)低成本跑通光影融合与表情过渡,满意后再生成 720p 高清视频成片。
  • 使用面部细节高保真的参考图:提供光照自然、面部五官锐利的单人正面或微侧面图,能保证在近景特写运镜中维持极高质感。

注意事项与操作规范

  • 严格单张图片输入数组:image_urls 参数必须为数组格式且恰好包含一个公开 HTTP(S) 图片 URL,不支持多张图片或 Base64 编码。
  • 源视频大小与时长规范:源视频必须为公开可访问的 HTTP(S) 地址,文件体积限制在 100 MiB 以内。时长由服务端自动探测,请勿传入 duration 字段。
  • 整秒向上取整计费规则:积分消耗按 ceil(源视频秒数) × 费率计算。例如 5.1 秒视频在 480p 档位将按 6 秒扣除 42 积分。
  • 失败自动全额返还保障:提交时预扣积分,若素材探测异常或后台生成失败,扣除的积分将全额自动返还至用户账户。

相关模型

Wan Animate Replace API 常见问题

Wan Animate Replace API 是什么?

Wan Animate Replace 是阿里研发的视频级角色置换与换人模型。它将源视频中的原始人物置换为参考图中的目标角色肖像,并完整保留原始镜头运镜、环境光影投射与场景空间关系,支持 480p、580p 与 720p 分辨率输出。基于 Wan2.2-Animate 的 14B 参数多模态生成架构,它在维持原视频背景结构与物理交互的同时,高精度贴合目标角色的面容身份与服装造型。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。

Wan Animate Replace 如何保留原视频的背景与运镜?

Wan Animate Replace 采用时空扩散注意力机制,能够将演员的前景动态掩码与背景环境解耦。它逐帧追踪源视频的摄像机推拉摇移、视差与景深虚化效果,确保仅对目标角色区域进行置换重绘,而周围场景、道具与建筑物背景保持像素级稳定。

Wan Animate Replace 需要提供哪些输入素材?

Wan Animate Replace 核心接收两项必要素材:一是通过 video_url 传入包含待替换演员的源视频公开链接,二是在 image_urls 数组中传入恰好一个目标人物肖像的公开 HTTP(S) 图片链接。输出分辨率可选填 480p、580p 或 720p。

Wan Animate Replace 如何实现自然的光影与边缘融合?

模型内置环境光感知与自适应匹配算法,能自动分析源视频中的光源方向、色彩明暗与反射高光。新角色进入画面后会自动投射与环境相符的阴影,并在面部和衣物表面融入场景漫反射色调,结合细腻的边缘羽化实现自然融合。

Wan Animate Replace 任务如何计算积分扣除?

计费规则根据服务端实际探测到的源视频时长向上取整到整秒,乘以所选分辨率单价:480p 档位为 7 积分/秒($0.035/秒),580p 为 12 积分/秒($0.060/秒),720p 为 15 积分/秒($0.075/秒)。若因参数校验不通过或生成异常中断,扣除的积分将全额自动返还。

Wan Animate Replace 支持哪些分辨率档位?

Wan Animate Replace 支持 480p(默认)、580p 与 720p 三种分辨率。480p 成本最低适合快速打样和预览换人契合度;580p 兼具画质与渲染效率适合社媒内容;720p 具备最高清晰度与细腻皮肤质感,适合专业广告与影视成品制作。

制作角色换人视频时为什么选择 Wan Animate Replace?

当你希望在既有成片中将某位演员或模特置换为新形象,同时完整保留现场环境布置、复杂机位运动与真实光影时,Wan Animate Replace 是最佳方案;若你仅有孤立的角色静态立绘,并希望提取参考视频的动作让角色动起来,则应选用 Wan Animate Move 端点。