FaceDetailer (pipe)有哪些输入参数？

共 3 个输入，包括 image（image）、detailer_pipe（detailer_pipe）、scheduler_func_opt（scheduler_func_opt）。

FaceDetailer (pipe)的输出是什么？

共 6 个输出：image（image）、cropped_refined（cropped_refined）、cropped_enhanced_alpha（cropped_enhanced_alpha）、遮罩（mask）、detailer_pipe（detailer_pipe）、cnet_images（cnet_images）。

FaceDetailer (pipe)有哪些可调参数？

共 28 个控件参数，包括 guide_size（guide_size）、guide_size_for（guide_size_for）、max_size（max_size）、seed（seed）、steps（steps）、cfg（cfg）。

FaceDetailer (pipe)属于哪个节点包？

属于「ComfyUI-Impact-Pack」，节点分类为「第三方插件」。

首页/ 节点库/ FaceDetailer (pipe)

第三方插件 ComfyUI-Impact-Pack

FaceDetailer (pipe)

专门用于面部细节增强的管道节点。FaceDetailer (pipe)-

FaceDetailer (pipe) 2026-01-28 收录 766 次浏览

节点中英文对比

ComfyUI 结构对照

按当前节点配置，分别展示中文与英文节点结构。面板按 ComfyUI 实际界面还原：左侧圆点是输入，右侧圆点与该行最右的名称为输出，下方胶囊是控件参数；控件两端的三角表示可切换的选项。

中文节点 37 项

FaceDetailer (pipe)

image image

detailer_pipe cropped_refined

scheduler_func_opt cropped_enhanced_alpha

遮罩

detailer_pipe

cnet_images

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 —

英文节点 37 项

FaceDetailer (pipe)

image image

detailer_pipe cropped_refined

scheduler_func_opt cropped_enhanced_alpha

mask

detailer_pipe

cnet_images

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 —

模型条件 / 数值 Latent 其它类型左圆点 = 输入，右圆点 = 输出可切换选项 — 未设置默认值

面板用于对照参数位置与命名，不做交互；实际节点外观以 ComfyUI 内的主题为准。

参数说明

输入 3 · 输出 6 · 控件 28

依据当前节点关联的 NodesItems 数据，按输入、输出、控件三类分别列出名称与说明。

输入参数 3 项

image image

输入图像，支持单图或多图。

detailer_pipe detailer_pipe

包含模型、clip、vae、提示词等上下文配置。

scheduler_func_opt scheduler_func_opt

可选。调度器自定义函数。

输出参数 6 项

image image

主图像，经过细化后返回。

cropped_refined cropped_refined

细化前裁剪区域的图像。

cropped_enhanced_alpha cropped_enhanced_alpha

带透明通道的增强图像。

遮罩 mask

识别出的所有区域掩码合并图。

detailer_pipe detailer_pipe

回传处理上下文管道，包含 clip、vae、模型等配置信息。

cnet_images cnet_images

控制图像（ControlNet 专用）。

控件参数 28 项

guide_size guide_size

引导裁剪区域的尺寸，默认 512。

guide_size_for guide_size_for

guide_size 是否作用于 bbox（开启）或裁剪区域（关闭）。建议保持开启以获得更好的面部覆盖范围。

max_size max_size

放大后区域允许的最大尺寸，单位为像素。可防止生成区域过大，通常不超过模型支持的最大输入。

seed seed

随机数种子。

steps steps

采样步数。

cfg cfg

提示词引导系数。

sampler_name sampler_name

采样器名称。

scheduler scheduler

调度器名称。

denoise denoise

去噪强度。

feather feather

掩码羽化像素数，用于平滑边缘。

noise_mask noise_mask

是否启用掩码作为噪声引导。

force_inpaint force_inpaint

是否强制使用 inpaint 模式修复区域。

bbox_threshold bbox_threshold

BBox 检测置信度阈值。

bbox_dilation bbox_dilation

对检测框进行扩大（正数）或缩小（负数）像素处理。

bbox_crop_factor bbox_crop_factor

裁剪区域扩展比例，默认值 3.0。

sam_detection_hint sam_detection_hint

SAM 采样提示方式，如中心点、四角、掩码均值等。

sam_dilation sam_dilation

SAM 输出掩码膨胀像素数。

sam_threshold sam_threshold

SAM 掩码阈值，决定区域精确度。推荐 0.93 左右，可微调获取更严或宽掩码。

sam_bbox_expansion sam_bbox_expansion

SAM 的 BBox 区域扩展值。配合 bbox 使用提升区域边界容错度。

sam_mask_hint_threshold sam_mask_hint_threshold

SAM mask 提示强度阈值。一般设置为 0.7，越高表示越依赖提示区域。

sam_mask_hint_use_negative sam_mask_hint_use_negative

是否使用负提示作为 mask 引导（如 small、outer 区域）。推荐 Outter 用于保留主区域。

drop_size drop_size

过滤掉面积小于该值的检测区域。推荐设置为 10~30，避免小噪声区域干扰生成。

refiner_ratio refiner_ratio

使用 refiner（细化器）模型的融合比例。建议设置为 0.2~0.5，开启后可提升细节但耗时增加。

cycle cycle

多轮细化次数。默认值为 1。

inpaint_model inpaint_model

可选。是否启用专用 inpaint 模型进行细化。

noise_mask_feather noise_mask_feather

噪声掩码额外羽化像素数。

tiled_encode tiled_encode

启用 VAE 编码分块处理。对大图像有效，可缓解显存压力。

tiled_decode tiled_decode

启用 VAE 解码分块处理。

节点详解

原理 · 用法 · 常见问题

暂无节点说明

常见问题

按节点参数整理

FaceDetailer (pipe)是做什么的？: 专门用于面部细节增强的管道节点。FaceDetailer (pipe)-
FaceDetailer (pipe)有哪些输入参数？: 共 3 个输入，包括 image（image）、detailer_pipe（detailer_pipe）、scheduler_func_opt（scheduler_func_opt）。
FaceDetailer (pipe)的输出是什么？: 共 6 个输出：image（image）、cropped_refined（cropped_refined）、cropped_enhanced_alpha（cropped_enhanced_alpha）、遮罩（mask）、detailer_pipe（detailer_pipe）、cnet_images（cnet_images）。
FaceDetailer (pipe)有哪些可调参数？: 共 28 个控件参数，包括 guide_size（guide_size）、guide_size_for（guide_size_for）、max_size（max_size）、seed（seed）、steps（steps）、cfg（cfg）。
FaceDetailer (pipe)属于哪个节点包？: 属于「ComfyUI-Impact-Pack」，节点分类为「第三方插件」。

欢迎来到圆圈网

FaceDetailer (pipe)

节点中英文对比

参数说明

节点详解

常见问题

同类节点