ComfyUI 自定义节点,基于 SimSwap 实现人脸交换(Face-Swapping)。
- 一键换脸:将源图像中的人脸身份迁移到目标图像的人脸上
- 支持多人脸:目标图像中包含多张人脸时,全部替换
- 两种分辨率:支持 224×224 和 512×512(HQ)两种对齐尺寸
- 可选遮罩:使用人脸解析遮罩实现更平滑的融合效果
cd ComfyUI/custom_nodes/
git clone https://github.com/yourname/ComfyUI-SimSwap.git
cd ComfyUI-SimSwap
pip install -r requirements.txt- insightface — 人脸检测 + 关键点定位(自动下载 antelope 模型)
- onnxruntime-gpu — InsightFace 的 ONNX 推理后端(如需 CPU 可换
onnxruntime) - huggingface-hub — 自动下载 SimSwap 模型权重
首次运行节点时,会自动从 HuggingFace 下载以下模型到 ComfyUI/models/simswap/:
| 模型 | 文件 | 大小 |
|---|---|---|
| ArcFace ID Extractor | arcface_checkpoint.tar |
~130 MB |
| SimSwap Generator | latest_net_G.pth |
~340 MB |
| InsightFace Antelope | (自动下载到模型目录) | ~200 MB |
下载链接来自 eziorojas/simswap-models。
| 输入 | 类型 | 说明 |
|---|---|---|
source_image |
IMAGE |
提供身份信息的人脸图像 |
target_image |
IMAGE |
要被替换人脸的目标图像 |
crop_size |
[224, 512] |
对齐裁剪尺寸(224 为原始版,512 为 HQ 版) |
use_mask |
BOOLEAN |
是否启用遮罩融合(需额外下载 BiSeNet 模型) |
| 输出 | 类型 | 说明 |
|---|---|---|
swapped_image |
IMAGE |
换脸结果图像 |
[Load Image: source] → [SimSwap Face-Swap] → [Save Image]
[Load Image: target] → → [Preview Image]
- GPU 要求:建议使用 NVIDIA GPU(CUDA),CPU 模式速度较慢
- 人脸大小:目标图像中的人脸像素面积建议 > 80×80 以获得较好效果
- 多人脸:源图像中检测到的最高置信度人脸作为身份来源;目标图像中所有检测到的人脸均被替换
- 遮罩模式:
use_mask=True时需额外下载 BiSeNet 解析模型,融合更自然但速度略慢
- SimSwap — 原始项目与模型权重
- InsightFace — 人脸检测与对齐