用途:通过 verging.ai API 在视频中进行 AI 换脸,以命令行方式调用。
主要能力:支持本地视频文件或 YouTube/Bilibili 视频 URL,支持本地或远程人脸图片;可指定起止时间裁剪视频,支持普通与 HD 模式,可自动下载结果。
使用方式:命令格式为 /faceswap --video <视频文件或URL> --face <人脸图片或URL> [选项]。常用选项包括 --start/-s 起始秒数、--end/-e 结束秒数、--hd 高清模式、--api-key/-k 密钥(默认读取 $VERGING_API_KEY)、--output/-o 保存路径、--download/-d 自动下载。认证推荐使用 Authorization: ApiKey <key>,Bearer <key> 亦可。API 密钥在 verging.ai 登录后于 Avatar → API Keys 获取。
执行流程:解析参数;用 yt-dlp 下载远程视频、curl 下载远程图片;用 ffprobe 获取时长,必要时用 ffmpeg 裁剪;查询额度;仅视频需经 /upload-video 获取预签名 URL 后 PUT 上传;通过 /faceswap/create-job 以 multipart 直接上传人脸图片并创建任务;每 5 秒轮询 /faceswap/jobs?job_ids=X 直至 COMPLETED;返回或下载结果。
限制:视频最长 30 秒,超长需先裁剪;普通模式 1 积分/秒,HD 模式 3 积分/秒;/upload-video 必须使用表单数据而非 JSON;人脸图片无需单独上传;临时目录为 /tmp/verging-faceswap/,使用后应清理;若缺少 yt-dlp 需手动下载视频;仅处理拥有权利的媒体,勿泄露 API 密钥。