AI人脸识别技术支持换脸视频：使用 Claude 批量替换任意视频中的人脸

你已经在各处见过 AI 换脸视频的流行趋势——朋友出演电影名场面、创作者在自己的小短剧中一人分饰多角、品牌在不重拍的情况下更换主讲人。很好玩。但还有一个版本没人告诉你：如果你能拿一支视频，在一次批量处理中生成 10 个不同版本，每个版本是不同的脸，而且整个工具在你自己的电脑本地私密运行，会怎样？

这正是我们今天要搭建的东西，使用 YouCam AI Video Face Swap API 和 Claude。不需要编程技能，无需把视频上传到来路不明的网站。一条提示词，一个免费的 API 密钥，你就能拥有自己的批量换脸视频工具。

只要三步，我们开始。

开始前你需要准备什么

• Claude Cowork：Anthropic 的智能代理工作空间应用，它会为你生成这个工具。
• 一个 YouCam API 密钥：免费注册，即可获得40 个免费点数，马上开始换脸。
• 一个目标视频：即其中的人脸将被替换的视频。
• 几张人脸照片：你希望替换进去的人脸照片，一次最多 10 张。每张人脸都会生成一支单独的换脸视频。

就这些。不需要剪辑软件，也不会带有各类免费工具的随机水印。

步骤 1：让 Claude 构建你的换脸视频工具

打开 Claude Cowork，并粘贴下面的提示词。Claude 会构建一个小型本地 Web 工具，上传一个视频、导入多张人脸照片，然后针对同一支视频为每张人脸分别运行一次 AI 换脸，并在处理完成后依次显示结果。

以下是提示词——请整体复制：

我希望你为我构建一个本地工具，使用 玩美移动 的 YouCam「AI Video Face Swap」API（face-swap-vid），将某张人脸替换到目标视频中。我已经有 YouCam 的 API 密钥，并会在工具的 UI 中自行粘贴——不要在本次对话中向我索要密钥。

功能需求
* 构建一个本地提供服务的 Web UI，使我可以：
* 上传一个目标视频（其人脸将被替换的视频）。在加载完成后显示预览播放器，并自动读取其时长。
* 一次性上传多张参考人脸照片（最多 10 张），显示缩略图预览，并可在提交前删除任意照片。
* 设置输出时长（秒）（dst_duration），默认自动填入已上传视频的实际时长（向上取整，最大不超过 30 秒），并允许我编辑。
* 点击一个按钮即可启动整个批处理。针对每一张参考人脸照片，都对同一个目标视频发起一条独立的人脸替换任务——复用同一个视频上传，不要为每张人脸重复上传视频。任务完成后逐个显示结果。不要等最慢的任务结束后才显示第一个结果——每张人脸一张卡片：显示该人脸缩略图、处理中时的加载动画，完成后在卡片中内联播放最终替换后的视频，并提供一个链接以全尺寸打开。如果某一条人脸替换失败，只在该卡片上显示错误，其余批次任务应继续执行。

关于此 API 你需要了解的技术要点
* 基础 URL： https://yce-api-01.makeupar.com
* 认证：V2 API——在每个请求上添加“Authorization: Bearer YOUR_API_KEY”即可，无需单独的 token 交换调用。
* 文件上传流程：向 /s2s/v2.0/file/face-swap-vid 发送 POST 请求，body 为 { "files": [{ "content_type", "file_name", "file_size" }] }。此同一端点用于注册目标视频和每一张参考人脸图片——只需针对每个文件调用一次，设置正确的 content_type（如 "video/mp4" 或 "image/jpeg" 等）。响应中包含 file_id 以及预签名上传 URL（requests[0].url / requests[0].method）——调用该端点并不会真正上传文件；你必须另外对该 URL 发送 PUT 请求上传原始文件字节。对该 PUT 请求不要转发 Content-Length 头；应让 HTTP 客户端自行设置，否则上传会失败。file_id / requests 在 JSON 中的具体嵌套结构可能因文档版本而异，因此请以防御性方式解析注册响应（递归搜索这些键），不要假定固定结构。
* 文件限制：目标视频不得超过 30 秒，分辨率不高于 4K，帧率不高于 30 FPS；容器格式为 mov/mp4；文件大小上限为 100MB。该 API 仅支持含单一人脸的视频。
* 任务创建：向 /s2s/v2.0/task/face-swap-vid 发送 POST 请求，body 为 { "src_file_id": <video file_id>, "ref_file_id": <face file_id>, "dst_duration": <seconds> } → 返回 { "data": { "task_id" } }。
* 轮询：GET /s2s/v2.0/task/face-swap-vid/{task_id} → 检查任务状态。文档版本在此处不完全一致——有时结果在完成后会以顶层的裸 url 字段给出，且没有显式的 status 字段；有时则类似其他 YouCam 任务 API，嵌套在 data.task_status / data.results.url 下。请以防御性方式解析：如果找到结果 URL 即视为成功；否则查找显式的 task_status（running / success / error），若都未找到则默认视为 running。
* 频率限制：大约每个 API 密钥 300 秒内 250 个请求。在对多张人脸进行批处理上传/创建任务时，请限制并发量（例如一次并发 3 条），而不要一次性把所有请求全部发出。
* 这是一个服务器到服务器的 API。直接从浏览器 JavaScript 调用会因 CORS 导致失败（“Failed to fetch”）。请构建一个本地 Node.js/Express 服务器，保存 API 密钥并在服务器端代理所有对 Perfect Corp 的请求。浏览器端 UI 只能与本地服务器通信（例如 http://localhost:3939），绝不能直接调用 yce-api-01.makeupar.com。
* API 密钥不能写入磁盘。让浏览器以普通 JS 变量的形式持有它（来自 UI 输入框），并在每次请求本地服务器时通过自定义请求头（如 X-YCE-API-Key）发送；本地服务器在每个请求中读取该请求头，并向上游转发为“Authorization: Bearer <key>”。不要将密钥写入配置文件、环境变量文件，也不要在日志中打印。

UI 实现防护（避免已知问题）
* 对每个上传触发区域（“点击上传视频”/“点击上传人脸照片”），只绑定一次“点击打开文件选择器”的行为。常见错误：将隐藏的 <input type="file"> 包在一个 <label> 中，并且还在同一个 label 的 JS click 事件里调用 input.click()。label 的原生点击转发加上手动 .click() 调用，会导致每次点击触发两次文件选择器，并且在多数浏览器中第二次调用会取消第一次刚打开的对话框——结果表现为点击似乎毫无反应，且没有错误提示。请使用一个非 <label> 容器（例如 <div role="button" tabindex="0">）作为拖拽区域/点击目标，并仅通过一个 JS click 处理函数触发文件 input（另外加上 Enter/Space 的 keydown 处理，以保持键盘可访问性）。

交付 / 打包要求
* 使用原生 Node.js + Express + multer。无需构建步骤，无前端框架。
* 使用单页 HTML/CSS/JS 前端，由同一个 Express 服务器以静态文件形式提供（同源，因此服务器本身无须设置 CORS 配置）。
* 包含一个带依赖项的 package.json。
* 同时提供适用于 macOS 和 Windows 的双击启动脚本：macOS 上的 .command 文件和 Windows 上的 .bat 文件。每个脚本需：cd 到脚本所在目录，仅在不存在 node_modules 时才运行 npm install，在短暂延迟后自动在浏览器中打开 http://localhost:3939，然后运行 npm start。执行 npm install 时，应将缓存目录指向项目本地缓存目录（Mac 使用 --cache "$(pwd)/.npm-cache"，Windows 使用 --cache "%cd%\.npm-cache"），而不是使用全局 npm 缓存——某些机器的全局 npm 缓存已损坏或权限异常，会导致安装失败，这一做法可以完全规避该故障模式。
* 在交付给我之前，请自行测试服务器逻辑——验证文件上传 / 任务创建 / 轮询请求结构在真实 API 上可以工作。如果我尚未提供真实密钥，请使用一个刻意无效的密钥进行验证，并确认在各步骤收到预期的 401 响应，以证明端点和负载结构已正确接好。
* 还要对前端的上传 UI 做合理性检查（例如确认每个拖拽区域仅存在一个“点击到文件选择器”的绑定，符合上述防护要求），而不是只测试服务器路由。

Claude 会为您构建 AI API工具、测试AI API 连接，并将一个文件夹交给您。双击 start-mac.command（Mac）或 start-windows.bat（Windows），您的换脸工作室就会在 localhost:3939 打开。

步骤 2：获取免费的 YouCam API 密钥（含 40 个免费点数）

该工具基于同一款 YouCam AI 视频换脸引擎构建，该引擎也为 YouCam 在线换脸工具提供支持。要使用它，请访问 YouCam AI API 页面，注册账号并领取40 个免费点数——注册成功后即可获得。

从控制台复制您的 API 密钥。该工具从不保存密钥，它只存在于您的浏览器会话中，并随每次请求安全传输。不写入磁盘、不记录日志，只有您自己可以访问。

步骤 3：导入 1 个视频，导出 10 个换脸结果

回到本地工具中：

1. 在顶部粘贴您的 API 密钥。
2. 上传目标视频——工具会生成预览，并自动填充输出时长。
3. 上传最多 10 张人脸照片。会生成缩略图；如有变更，可移除不需要的照片。
4. 点击按钮。每张人脸会生成一个卡片，先显示加载动画，然后呈现对应的完成版换脸视频——可直接播放，并提供全尺寸链接。一次会并行处理 3 个换脸任务，即使其中某个失败，其余任务也会继续运行。

这正是批量处理发挥价值的地方。要测试哪位创作者的人脸在广告中表现最好？为群聊中的每个人制作个性化短片？用不同的主持人本地化同一条视频？都可以一键完成，而不必进行十次独立的编辑流程。

什么类型的视频最适合用于 AI 换脸？

以下是几条基础规范，有助于 AI 发挥最佳效果：

还有一点非常重要：请负责任地进行换脸。仅使用您拥有合法使用权的视频，以及已获得许可的人脸。

换脸技术应服务于创意内容、小剧场、营销活动和在取得同意前提下的粉丝内容，而不是用于冒充他人或误导行为。

目前很多平台都会要求创作者标注 AI 生成内容，这种透明度本身也有利于您的品牌形象。

为什么要使用 YouCam API 自建，而不是找一个免费的随机工具？

这是合理的考量。免费的换脸网站很多，但通过这种方式，您可以获得它们通常不具备的能力：

• 原生支持批量处理。一次运行即可对同一视频完成最多十张人脸的换脸——大多数免费工具只能一次处理一个结果。
• 从架构层面保障隐私。工具在本地运行，并直接与 YouCam API 通信。没有第三方网站将您的视频锁在付费墙后。
• 可扩展到生产环境。这就是您未来在自有应用或营销工作流中集成换脸功能所使用的开发者 API。今天它是桌面工具，明天就可以成为您交付的正式功能。

它也可以与其余的 YouCam AI 技术栈很好地配合使用，我们已经通过肤质分析展示了相同的 Claude 加 API 模式。

准备好进行您的第一个替换了吗？注册使用 YouCam AI API，领取 40 个免费额度，您就能在午饭前批量生成一组换脸视频。

** 注意： Youcam AI API 目前适用于海外市场，暂不支持大陆市场

常见问题：使用 YouCam 与 Claude 进行 AI 视频换脸

什么是 AI 视频换脸？

AI 会在视频中逐帧将一个人脸替换为另一个人脸，同时保留原始表情、头部运动和光线效果，使结果看起来自然，而不是简单拼贴。YouCam face-swap-vid API 会自动完成跟踪和融合。

YouCam AI 视频换脸 API 是否可以免费试用？

可以——注册后您将获得 40 个免费额度，足以跑完首批换脸任务并自行评估质量。之后采用按量计费模式。

我可以一次替换多个面孔吗？

既可以又不可以，这个区别很关键。目标视频本身必须只包含一张人脸；该 API 不支持在单个视频中对多个人进行换脸。批处理工具的作用是针对这一条单人脸视频，最多运行 10 个独立的换脸任务，每次替换一个新面孔，并输出一个对应的视频。所以：视频中只有一张脸，但可以输出十个不同版本。

生成一条换脸视频需要多长时间？

对于短视频片段，每次换脸通常在一分钟之内即可完成，并且工具会并行运行三个任务，因此完整一批 10 条视频并不会带来 10 倍的等待时间。

我的内容是否安全？

该工具在您的本地设备上运行，您的 API 密钥不会被写入磁盘或记录日志。上传内容会直接发送到 YouCam 的安全 API——中间不存在任何第三方网站。

换脸是否合法？

将您自己拥有或已获授权使用的内容用于创意目的——是可以的。伪装真实人物以实施欺诈、骚扰或欺骗则是不被允许的（也被明令禁止）。在公开分享内容时，请在平台要求的场景下标注 AI 生成内容。

如果使用过程中遇到问题怎么办？

欢迎随时联系我们——联系 玩美移动 销售团队，我们将协助您搭建并优化换脸工作流程。