ReActor ? Fast Face Swap
节点功能:ReActor 是一个用于 ComfyUI 的快速人脸替换扩展节点,它允许用户在图像中替换人脸。该节点具有 NSFW 检测功能,以避免在不适当的内容上使用。ReActor ? Fast Face
节点中英文对比
ReActor ? Fast Face Swap
enabled
swap_model
facedetection
face_restore_model
face_restore_visibility
codeformer_weight
detect_gender_input
detect_gender_source
input_faces_index
source_faces_index
console_log_level
ReActor ? Fast Face Swap
enabled
swap_model
facedetection
face_restore_model
face_restore_visibility
codeformer_weight
detect_gender_input
detect_gender_source
input_faces_index
source_faces_index
console_log_level
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 为调试详细日志。
暂无节点说明