用途:faceswap 是一个基于 HeyGen API 的视频换脸工作流技能,主要用于把源图片中的人脸替换到目标视频里的人脸上。资料描述了两类场景:一是替换视频中的人脸,二是把源图片的人脸换到目标视频上。
主要能力:通过 POST /v1/workflows/executions 提交换脸任务,workflow_type 必须为 "FaceswapNode",input 中包含 source_image_url(待换入的人脸图片 URL)和 target_video_url(接收换脸的目标视频 URL)。提交成功后返回 execution_id,再通过 GET /v1/workflows/executions/{execution_id} 查询状态。任务完成时,output.video_url 返回换脸后的视频地址。资料还展示了将数字人视频生成与换脸串联的示例:先以 AvatarInferenceNode 生成数字人视频,再将该视频作为目标视频进行换脸。
使用方式:所有请求都需要在请求头中携带 X-Api-Key,并设置 HEYGEN_API_KEY 环境变量。资料提供了 curl、TypeScript 与 Python 的调用示例,以及轮询完成的实现:每 10 秒查询一次,直到状态变为 completed;遇到 failed 或 not_found 时抛出错误,超过最大等待时间则报超时。
适用场景:把人物头像或照片合成到已有视频中;对数字人视频进行个性化换脸;对录制视频中的可见人脸进行替换。
限制与注意事项:人脸源图片应清晰、正面、光线良好,并只包含一张人脸;源图片分辨率越高,效果通常越好。换脸依赖 GPU,资料提示处理时间约 1-3 分钟,因此建议轮询间隔为 10 秒。目标视频需要包含可见人脸。收费、价格与配额信息暂未提供。