AI MediaKit 的视频人脸融合工具，能够将用户提供的目标人脸照片融合替换到视频中的人物上，输出高质量换脸视频，同步保持原视频的动作、背景、脸型、表情和口型。此功能主要适用于生成式视频脱敏需要换脸的场景。当前仅支持单人换脸。本篇开发指南将引导您： * 快速体验为视频替换目标人脸。 * 了解视频人脸融合工具的输入规范、输出结果与使用限制。 ## 效果预览通过视频人脸融合工具，您可以将一个包含人脸的视频作为输入，并提供一张目标人脸图片，快速生成一个视频中人脸被替换为目标人脸的换脸视频。 |换脸前视频 |目标人脸图片 |换脸后视频 | |---|---|---| |

|![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/ec345c3dd73b41139d8953e164951634) |

| ## 快速体验：将视频中的人脸替换为目标人脸本节将演示如何使用 `face-swap-video` 工具，将一个视频中的主体人脸替换为您提供的目标人脸照片。 ### 准备工作 * **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 * **准备视频文件**：准备一个待换脸的视频，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 * **准备目标人脸照片**：准备一张清晰可见、无遮挡的正脸照片（JPEG/PNG 格式，建议分辨率 256×256～1080×1080），并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。

说明

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

### 操作流程视频人脸融合是一个异步任务，完整流程如下： 1. 成功调用 `POST /api/v1/tools/face-swap-video` 提交任务后，您将获得一个任务 ID。 2. 您可以轮询 `GET /api/v1/tasks/{task_id}` 接口，直到任务状态 `status` 变为 `completed`；或者使用[事件回调](https://www.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，解析响应中的 `result` 字段，即可在 `video_url` 字段获取最终生成的视频文件下载地址。 #### 第 1 步：提交任务您需要调用[提交视频人脸融合（换脸）任务 API](https://www.volcengine.com/docs/6448/2563058)。可直接复制以下 cURL 命令，提交一个视频人脸融合任务。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/face-swap-video' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/demo_video_faceswap_virtual_tryon.mp4", "face_mappings": [ { "target_face_url": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/demo_img_faceswap_target_female.png" } ] }' ```

说明

将 {Your_API_Key} 替换为您的有效 API Key。

video_url：示例中已提供可直接用于测试的演示视频 URL。您也可以将其替换为您自己的视频地址。

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

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-face-swap-video-123456789", "request_id": "20260629160000ABCDEFG12345" } ``` #### 第 2 步：获取结果您需要通过轮询[查询任务信息 API](https://www.volcengine.com/docs/6448/2278532)，直到任务状态 `status` 变为 `completed`。 ```Bash curl -X GET 'https://mediakit.cn-beijing.volces.com/api/v1/tasks/{task_id}' \ -H 'Authorization: Bearer {Your_API_Key}' ```

说明

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

当任务成功完成后，您将收到如下响应。您可以在 `result.video_url` 字段中找到最终生成的换脸视频下载地址（默认有效期为 24 小时）。 ```JSON { "success": true, "task_id": "amk-tool-face-swap-video-123456789", "request_id": "20260629160000ABCDEFG12345", "status": "completed", "result": { "video_url": "https://example.volcvideo.com/face_swap_result.mp4?auth_key=...", "duration": 180.5 }, "expires_at": 1777464650, "created_at": 1777291767, "finished_at": 1777291851 } ``` ## 参考信息 ### 使用限制 |限制项 |说明 | |---|---| |输入视频限制 |* **视频来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://www.volcengine.com/docs/6448/2536893)。

* **支持格式**：当前仅支持 MP4。

* **分辨率限制**：不得超过 1080P。

* **时长限制**：不得超过 10 分钟（600 秒）。

* **多人视频处理**：当前在处理包含多个人脸的视频时，会在每一帧中识别并替换尺寸最大的人脸。这可能导致在不同镜头或人物位置变化时，被替换的目标在不同人物间切换。为获得最佳效果，建议输入单人为主的视频。 | |目标人脸图限制 |* **文件来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`) 和火山引擎对象存储 (`tos://`) 三种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://www.volcengine.com/docs/6448/2536893)。

* **支持格式**：JPEG、PNG。

* **分辨率建议**：256×256～1080×1080。

* **画面要求**：一张清晰可见、无遮挡的正脸；不支持动漫人脸。 |

注意

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

### 计费说明视频人脸融合工具按输入视频时长计费，详细计费规则与单价请参见[视频人脸融合（按输入时长计费）](https://www.volcengine.com/docs/6448/2486473#ub3hj1zh)。 ## 相关 API 文档 * [提交视频人脸融合（换脸）任务 API](https://www.volcengine.com/docs/6448/2563058) * [查询任务信息 API](https://www.volcengine.com/docs/6448/2278532) * [事件回调](https://www.volcengine.com/docs/6448/2288701)