文档中心

AI MediaKit

视频工具

视频人脸融合（换脸）

AI MediaKit 的视频人脸融合工具，能够将用户提供的目标人脸照片融合替换到视频中的人物上，输出高质量换脸视频，同步保持原视频的动作、背景、脸型、表情和口型。此功能主要适用于生成式视频脱敏需要换脸的场景。当前仅支持单人换脸。

本篇开发指南将引导您：

效果预览

通过视频人脸融合工具，您可以将一个包含人脸的视频作为输入，并提供一张目标人脸图片，快速生成一个视频中人脸被替换为目标人脸的换脸视频。

换脸前视频	目标人脸图片	换脸后视频
Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag		Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

快速体验：将视频中的人脸替换为目标人脸

本节将演示如何使用 face-swap-video 工具，将一个视频中的主体人脸替换为您提供的目标人脸照片。

准备工作

获取访问凭证：在开始之前，访问 AI MediaKit 控制台 API Key 管理页面，创建并获取 AI MediaKit API Key（用于媒体处理功能鉴权）。

准备目标人脸照片：准备一张清晰可见、无遮挡的正脸照片（JPEG/PNG 格式，建议分辨率 256×256～1080×1080），并将其上传至公网可访问的服务器或视频点播服务中，以获取可供 API 调用的 URL。

说明

为方便您快速测试，本文后续步骤的示例代码中提供了可直接使用的演示视频和照片 URL。

操作流程

视频人脸融合是一个异步任务，完整流程如下：

您可以轮询 GET /api/v1/tasks/{task_id} 接口，直到任务状态 status 变为 completed；或者使用事件回调自动接收任务状态变化。

第 1 步：提交任务

您需要调用提交视频人脸融合（换脸）任务 API。可直接复制以下 cURL 命令，提交一个视频人脸融合任务。

说明

face_mappings[0].target_face_url：示例中已提供可直接用于测试的演示图像 URL，您也可以将其替换为您自己的目标人脸照片地址。当前仅支持单人换脸，face_mappings 数组传入一项即可。

请求成功后，您会收到如下包含 task_id 的响应，请保存此 ID 用于后续查询。

第 2 步：获取结果

您需要通过轮询查询任务信息 API，直到任务状态 status 变为 completed。

说明

需替换参数：将 URL 末尾的 {task_id} 替换为第 1 步返回的任务 ID。

当任务成功完成后，您将收到如下响应。您可以在 result.video_url 字段中找到最终生成的换脸视频下载地址（默认有效期为 24 小时）。

参考信息

使用限制

限制项	说明
输入视频限制	视频来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、来源于火山引擎视频点播 (vod://) 和火山引擎对象存储 (tos://) 四种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。支持格式：当前仅支持 MP4。分辨率限制：不得超过 1080P。时长限制：不得超过 10 分钟（600 秒）。多人视频处理：当前在处理包含多个人脸的视频时，会在每一帧中识别并替换尺寸最大的人脸。这可能导致在不同镜头或人物位置变化时，被替换的目标在不同人物间切换。为获得最佳效果，建议输入单人为主的视频。
目标人脸图限制	文件来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://) 和火山引擎对象存储 (tos://) 三种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。支持格式：JPEG、PNG。分辨率建议：256×256～1080×1080。画面要求：一张清晰可见、无遮挡的正脸；不支持动漫人脸。

注意

合规提示：您应确保您上传的图片和视频内容以及对生成内容的使用，符合相关法律法规和伦理规范。请勿将此功能用于侵犯他人肖像权、隐私权等合法权益，或用于任何非法、不道德或有害的活动。

计费说明

视频人脸融合工具按输入视频时长计费，详细计费规则与单价请参见视频人脸融合（按输入时长计费）。