ComfyUI-ReActor>ReActor 🌌 Fast Face Swap
ComfyUI-ReActor
时间：2025/06/28

ReActor 🌌 Fast Face Swap

节点功能：ReActor 是一个用于 ComfyUI 的快速人脸替换扩展节点，它允许用户在图像中替换人脸。该节点具有 NSFW 检测功能，以避免在不适当的内容上使用。
ReActor 🌌 Fast Face Swap-节点参数说明
输入参数
input_image目标图像，即将被换脸的图像，张量格式 [B, H, W, C]。确保图片中有人脸，否则后续流程将失败或跳过。
source_image源人脸图像。用于提取换脸所需面部特征。若未提供，必须传入 face_model。
face_model预生成的人脸特征结构。用于无需再次检测的场景，节省计算。
face_boost高级人脸增强结构，包含：enabled、boost_model、interpolation、visibility 等字段。：用于超清换脸场景，若启用需配置完整字段，适合对人脸清晰度要求极高的用户。
输出参数
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 为调试详细日志。

人脸修复模型介绍

模型文件名修复力度清晰度保真度可调节性最佳用途
CodeFormercodeformer-v0.1.0.pth★★★★☆★★★★☆★★★★☆✅（fidelity）模糊脸/老照片修复、人脸提升
GFPGAN v1.3GFPGANv1.3.pth★★★☆☆★★★☆☆★★★★★❌泛用修复、自然风格
GFPGAN v1.4GFPGANv1.4.pth★★★★☆★★★★★★★★☆☆❌写实风格、细节增强
GPEN-512GPEN-BFR-512.onnx★★★★☆★★★☆☆★★★☆☆❌中分辨率人脸修复
GPEN-1024GPEN-BFR-1024.onnx★★★★★★★★★★★★★☆☆❌高清人脸增强
GPEN-2048GPEN-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的人脸。

广告

可加入知识星球获取所有示例工作流

广告

微信扫码入群，加入AIGC大家庭，与大家一起交流学习