FaceDetailer (pipe)
节点功能：专门用于面部细节增强的管道节点。FaceDetailer (pipe)-
节点中英文对比
FaceDetailer (pipe)
guide_size
guide_size_for
max_size
seed
steps
cfg
sampler_name
scheduler
denoise
feather
noise_mask
force_inpaint
bbox_threshold
bbox_dilation
bbox_crop_factor
sam_detection_hint
sam_dilation
sam_threshold
sam_bbox_expansion
sam_mask_hint_threshold
sam_mask_hint_use_negative
drop_size
refiner_ratio
cycle
inpaint_model
noise_mask_feather
tiled_encode
tiled_decode
FaceDetailer (pipe)
guide_size
guide_size_for
max_size
seed
steps
cfg
sampler_name
scheduler
denoise
feather
noise_mask
force_inpaint
bbox_threshold
bbox_dilation
bbox_crop_factor
sam_detection_hint
sam_dilation
sam_threshold
sam_bbox_expansion
sam_mask_hint_threshold
sam_mask_hint_use_negative
drop_size
refiner_ratio
cycle
inpaint_model
noise_mask_feather
tiled_encode
tiled_decode
FaceDetailer (pipe) - 参数说明
输入参数
image
输入图像，支持单图或多图。
detailer_pipe
包含模型、clip、vae、提示词等上下文配置。
scheduler_func_opt
可选。调度器自定义函数。
输出参数
image
主图像，经过细化后返回。
cropped_refined
细化前裁剪区域的图像。
cropped_enhanced_alpha
带透明通道的增强图像。
mask
识别出的所有区域掩码合并图。
detailer_pipe
回传处理上下文管道，包含 clip、vae、模型等配置信息。
cnet_images
控制图像（ControlNet 专用）。
控件参数
guide_size
引导裁剪区域的尺寸，默认 512。
guide_size_for
guide_size 是否作用于 bbox（开启）或裁剪区域（关闭）。建议保持开启以获得更好的面部覆盖范围。
max_size
放大后区域允许的最大尺寸，单位为像素。可防止生成区域过大，通常不超过模型支持的最大输入。
seed
随机数种子。
steps
采样步数。
cfg
提示词引导系数。
sampler_name
采样器名称。
scheduler
调度器名称。
denoise
去噪强度。
feather
掩码羽化像素数，用于平滑边缘。
noise_mask
是否启用掩码作为噪声引导。
force_inpaint
是否强制使用 inpaint 模式修复区域。
bbox_threshold
BBox 检测置信度阈值。
bbox_dilation
对检测框进行扩大（正数）或缩小（负数）像素处理。
bbox_crop_factor
裁剪区域扩展比例，默认值 3.0。
sam_detection_hint
SAM 采样提示方式，如中心点、四角、掩码均值等。
sam_dilation
SAM 输出掩码膨胀像素数。
sam_threshold
SAM 掩码阈值，决定区域精确度。推荐 0.93 左右，可微调获取更严或宽掩码。
sam_bbox_expansion
SAM 的 BBox 区域扩展值。配合 bbox 使用提升区域边界容错度。
sam_mask_hint_threshold
SAM mask 提示强度阈值。一般设置为 0.7，越高表示越依赖提示区域。
sam_mask_hint_use_negative
是否使用负提示作为 mask 引导（如 small、outer 区域）。推荐 Outter 用于保留主区域。
drop_size
过滤掉面积小于该值的检测区域。推荐设置为 10~30，避免小噪声区域干扰生成。
refiner_ratio
使用 refiner（细化器）模型的融合比例。建议设置为 0.2~0.5，开启后可提升细节但耗时增加。
cycle
多轮细化次数。默认值为 1。
inpaint_model
可选。是否启用专用 inpaint 模型进行细化。
noise_mask_feather
噪声掩码额外羽化像素数。
tiled_encode
启用 VAE 编码分块处理。对大图像有效，可缓解显存压力。
tiled_decode
启用 VAE 解码分块处理。
暂无节点说明