核心用法
faceswap 是一款命令行 AI 视频换脸工具，通过 verging.ai 云端服务实现视频人脸替换。用户只需提供视频源（本地文件或 YouTube/Bilibili 链接）和目标人脸图片，即可生成换脸后的视频。
基础命令格式：
/faceswap --video <视频路径/URL> --face <人脸图片路径/URL> [选项]
关键功能特性：
- 多源输入：支持本地视频文件、YouTube/Bilibili 直链、本地或远程人脸图片
- 智能裁剪：自动根据
--start/--end参数或 30 秒上限裁剪视频 - 画质选择：标准模式（1 credit/秒）与 HD 高清模式（3 credits/秒）
- 实时进度：轮询任务状态，展示处理进度
- 自动下载：可选自动保存结果到本地
技术实现流程：解析参数 → 下载远程资源（yt-dlp/curl）→ 获取视频时长（ffprobe）→ 必要时裁剪（ffmpeg）→ 检查余额 → 上传视频至 R2 存储 → 创建换脸任务（人脸图片直接随请求上传）→ 轮询至完成 → 返回结果链接
显著优点
1. 集成度高：自动处理视频下载、格式转换、云端上传全流程，用户无需手动干预
2. 平台兼容：原生支持 Bilibili 和 YouTube，覆盖主流视频平台
3. 资源友好：30 秒时长限制避免过度消耗 credits，适合短视频场景
4. 标准化接口：采用 API Key 认证，支持环境变量注入，便于 CI/CD 集成
潜在局限与风险
功能局限：
- 时长硬性限制：仅支持 ≤30 秒视频，长视频需预处理分割
- 云端依赖：完全依赖 verging.ai 服务可用性与定价策略
- 无本地推理：所有处理在云端完成，无法离线使用
安全风险：
- API Key 泄露风险：需通过环境变量
VERGING_API_KEY配置，存在误提交至版本控制的可能 - 临时文件管理：使用
/tmp/verging-faceswap/目录，异常退出时可能残留敏感媒体文件 - 版权与合规：处理第三方视频存在版权风险，换脸内容可能涉及深度伪造（deepfake）法律边界
适合人群
- 内容创作者：快速生成换脸短视频、表情包、创意素材
- 开发者/自动化工程师：需要将换脸功能集成至工作流的 CLI 用户
- 社交媒体运营：批量生产轻量化视觉内容
常规风险提示
- Credits 消耗按秒计费，HD 模式成本 3 倍，需预估使用量
- 依赖
yt-dlp、ffmpeg、ffprobe、curl等外部二进制文件，需确保环境预装 - verging.ai 为第三方商业服务，存在 API 变更、价格调整或服务终止风险