| 参数名称 | 说明 |
|---|---|
| input_image | 目标图像，即将被换脸的图像，张量格式 [B, H, W, C]。确保图片中有人脸，否则后续流程将失败或跳过。 |
| source_image | 源人脸图像。用于提取换脸所需面部特征。若未提供，必须传入 face_model。 |
| face_model | 预生成的人脸特征结构。用于无需再次检测的场景，节省计算。 |
| face_boost | 高级人脸增强结构，包含：enabled、boost_model、interpolation、visibility 等字段。：用于超清换脸场景，若启用需配置完整字段，适合对人脸清晰度要求极高的用户。 |
ReActor 🌌 Fast Face Swap
节点功能：ReActor 是一个用于 ComfyUI 的快速人脸替换扩展节点，它允许用户在图像中替换人脸。该节点具有 NSFW 检测功能，以避免在不适当的内容上使用。
输入参数
输出参数
| 参数名称 | 说明 |
|---|---|
| IMAGE | 最终图像，类型为 [B, H, W, C]。包含换脸 → boost → 修复的图像处理结果。 |
| FACE_MODEL | 当前生成或传入的源人脸特征模型。用于连接后续换脸节点。不是图像，而是中间特征结构；可复用用于多个换脸目标，提升性能与一致性。 |
控件参数
| 参数名称 | 说明 |
|---|---|
| enabled | 启用换脸节点的主开关。OFF 时直接返回原图，无任何处理。 |
| swap_model | 指定使用的人脸替换模型，选项来自 model_names().keys() |
| facedetection | 用于检测图像中人脸位置的模型。支持 RetinaFace 和 YOLOv5 家族。 |
| face_restore_model | 指定用于修复人脸的模型（可选 .pth 或 .onnx 模型）。仅处理换脸区域。 |
| face_restore_visibility | 控制修复图与原图融合程度。范围：0.1 ~ 1.0，默认完全使用修复图。建议使用默认 1.0，若融合过度可能导致面部偏移。 |
| codeformer_weight | 仅在修复模型为 CodeFormer 时有效。范围 0.0 ~ 1.0 控制还原风格。 |
| detect_gender_input | 用于限定目标图中的性别，辅助源脸匹配。可选项为 "no", "female", "male"。多脸图像下提高匹配准确度。通常保持默认 “no”。 |
| detect_gender_source | 用于限定源图中性别，匹配目标图性别策略一致。 |
| input_faces_index | 目标图中要替换的人脸索引（字符串形式，如 "0"、"0,1"）。必须是字符串形式，数字间用英文逗号分隔，顺序影响匹配。 |
| source_faces_index | 源图中被选中用于换脸的人脸索引。（字符串形式，如 "0"、"0,1"）。必须是字符串形式，数字间用英文逗号分隔，顺序影响匹配。在源图存在多张人脸时非常关键，索引不匹配会导致错误替换。 |
| console_log_level | 控制台日志级别。0 为静默，1 为正常，2 为调试详细日志。 |
人脸修复模型介绍
| 模型 | 文件名 | 修复力度 | 清晰度 | 保真度 | 可调节性 | 最佳用途 |
|---|---|---|---|---|---|---|
| CodeFormer | codeformer-v0.1.0.pth | ★★★★☆ | ★★★★☆ | ★★★★☆ | ✅（fidelity） | 模糊脸/老照片修复、人脸提升 |
| GFPGAN v1.3 | GFPGANv1.3.pth | ★★★☆☆ | ★★★☆☆ | ★★★★★ | ❌ | 泛用修复、自然风格 |
| GFPGAN v1.4 | GFPGANv1.4.pth | ★★★★☆ | ★★★★★ | ★★★☆☆ | ❌ | 写实风格、细节增强 |
| GPEN-512 | GPEN-BFR-512.onnx | ★★★★☆ | ★★★☆☆ | ★★★☆☆ | ❌ | 中分辨率人脸修复 |
| GPEN-1024 | GPEN-BFR-1024.onnx | ★★★★★ | ★★★★★ | ★★★☆☆ | ❌ | 高清人脸增强 |
| GPEN-2048 | GPEN-BFR-2048.onnx | ★★★★★ | ★★★★★ | ★★★☆☆ | ❌ | 超高清人像修复/人脸特写 |
face_restore_visibility：人脸恢复可见度，值越大，人脸越清晰，但是人脸的相似度相应下降。红色值为face_restore_visibility，绿色值为dist，值越小，代表与参考图越像。
codeformer_weight：CodeFormer模型权重，只在使用codeformer-v0.1.0.pth模型时有效。红色值为权重，绿色值为dist，值越小，代表与参考图越像。
- detect_gender_input：输入图像性别检测选项
- detect_gender_source：源图像性别检测选项
- input_faces_index：输入图像人脸索引
- source_faces_index：源图像人脸索引
当场景中有多张人脸时，则需要指定性别进行换脸。
在以下场景中，input_faces_index=1，则替换索引1的人脸。