第三方插件 ComfyUI-ReActor

ReActor ? Fast Face Swap

ReActor ? Fast Face Swap 229

ReActor 是一个用于 ComfyUI 的快速人脸替换扩展节点,它允许用户在图像中替换人脸。该节点具有 NSFW 检测功能,以避免在不适当的内容上使用。ReActor ? Fast Face

节点中英文对比

按当前节点配置,分别展示中文与英文节点结构。

中文节点
ReActor ? Fast Face Swap
  • input_image
  • source_image
  • face_model
  • face_boost
  • IMAGE
  • FACE_MODEL
  • 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
  • source_image
  • face_model
  • face_boost
  • IMAGE
  • FACE_MODEL
  • 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

    参数说明

    依据当前节点关联的 `NodesItems` 数据展示输入、输出与控件说明。

    输入参数
    input_image input_image
    目标图像,即将被换脸的图像,张量格式 [B, H, W, C]。确保图片中有人脸,否则后续流程将失败或跳过。
    source_image source_image
    源人脸图像。用于提取换脸所需面部特征。若未提供,必须传入 face_model。
    face_model face_model
    预生成的人脸特征结构。用于无需再次检测的场景,节省计算。
    face_boost face_boost
    高级人脸增强结构,包含:enabled、boost_model、interpolation、visibility 等字段。:用于超清换脸场景,若启用需配置完整字段,适合对人脸清晰度要求极高的用户。
    输出参数
    IMAGE IMAGE
    最终图像,类型为 [B, H, W, C]。包含换脸 → boost → 修复的图像处理结果。
    FACE_MODEL FACE_MODEL
    当前生成或传入的源人脸特征模型。用于连接后续换脸节点。不是图像,而是中间特征结构;可复用用于多个换脸目标,提升性能与一致性。
    控件参数
    enabled enabled
    启用换脸节点的主开关。OFF 时直接返回原图,无任何处理。
    swap_model swap_model
    指定使用的人脸替换模型,选项来自 model_names().keys()
    facedetection facedetection
    用于检测图像中人脸位置的模型。支持 RetinaFace 和 YOLOv5 家族。
    face_restore_model face_restore_model
    指定用于修复人脸的模型(可选 .pth 或 .onnx 模型)。仅处理换脸区域。
    face_restore_visibility face_restore_visibility
    控制修复图与原图融合程度。范围:0.1 ~ 1.0,默认完全使用修复图。建议使用默认 1.0,若融合过度可能导致面部偏移。
    codeformer_weight codeformer_weight
    仅在修复模型为 CodeFormer 时有效。范围 0.0 ~ 1.0 控制还原风格。
    detect_gender_input detect_gender_input
    用于限定目标图中的性别,辅助源脸匹配。可选项为 "no", "female", "male"。多脸图像下提高匹配准确度。通常保持默认 “no”。
    detect_gender_source detect_gender_source
    用于限定源图中性别,匹配目标图性别策略一致。
    input_faces_index input_faces_index
    目标图中要替换的人脸索引(字符串形式,如 "0"、"0,1")。必须是字符串形式,数字间用英文逗号分隔,顺序影响匹配。
    source_faces_index source_faces_index
    源图中被选中用于换脸的人脸索引。(字符串形式,如 "0"、"0,1")。必须是字符串形式,数字间用英文逗号分隔,顺序影响匹配。在源图存在多张人脸时非常关键,索引不匹配会导致错误替换。
    console_log_level console_log_level
    控制台日志级别。0 为静默,1 为正常,2 为调试详细日志。

    详细说明

    结合节点用途、参数和调用方式,给出更完整的说明内容。

    暂无节点说明

    同类节点导航

    继续浏览同一分类下的相邻节点,方便串联学习。