Keyer（抠像器） · 截图待补
这个节点做什么
Keyer（抠像器）用若干策略之一从素材构建遮罩：按亮度（luminance）抠、按指定颜色（color）抠、按绿/蓝幕布（screen）抠，或用 none 直通。与单滑块的色度抠像不同，它给你一整条抠像曲线 —— 一个中心点，加上暗端（下侧）和亮端（上侧）各自独立的容差与柔度 —— 让你精确塑造保留哪些值。它还带角度式去溢色以清理幕布边缘。 输入与输出都是COMFYTV_VIDEO。它带有 ▶ Run。
与 PIK Keyer 一样，它自动选择模式：接入任一侧输入（in/out 遮罩或背景）则运行完整渲染；留空则运行快速、可预览的单图抠像。
何时使用
- 你想按亮度抠（如隔离高光或阴影）而非按颜色。
- 幕布抠像需要不对称处理 —— 阈值一侧比另一侧更紧。
- 你需要比 Chroma Key 更精细的边缘塑形，但又不想用干净背景板。
参数
mode
抠像策略：luminance（默认）、color、screen 或 none。
key_color
color/screen 模式的参考颜色。十六进制，默认 #000000。
抠像曲线（softness_lower、tolerance_lower、center、tolerance_upper、softness_upper）
这五个参数从暗到亮塑造哪些值变成遮罩：- softness_lower —— 下侧容差以下的羽化。范围
-1.0–0.0，默认-0.5。 - tolerance_lower —— 中心以下多远仍完全保留。范围
-1.0–0.0，默认0.0。 - center —— 抠像围绕的中心值。范围
0.0–1.0，默认1.0。 - tolerance_upper —— 中心以上多远仍完全保留。范围
0.0–1.0，默认0.0。 - softness_upper —— 上侧容差以上的羽化。范围
0.0–1.0，默认0.5。
despill / despill_angle
溢色抑制强度及其色相角度。despill 范围 0.0–2.0，默认 1.0（0=关闭）。despill_angle 范围 0–180 度，默认 120（绿色）。把角度设向你的幕布色相。
output
matte（默认）为灰度蒙版，alpha 为真实透明，premult 为预乘 RGB，composite 为叠在背景上渲染。（alpha 需要 VP9 编码器 —— 报错就用 matte。）
侧输入（可选）
- video —— 要抠的画面。
- in_mask —— 强制区域完全不透明（保留）。
- out_mask —— 强制区域完全透明（去除）。
- bg_video —— 当
output为composite时使用的背景。
输出
提示
- 做亮度抠像时，先设
mode=luminance，把center设在分界处，再放大容差/柔度直到遮罩满意。 - 接入侧输入会切换到完整渲染模式；不接则保持可实时预览的抠像。
- 要与原生 ComfyUI 节点互通，请插入 Bridge。见 bridges.md。
相关节点
- Chroma Key —— 更简单的单色抠像。
- PIK Keyer —— 应对最难幕布的干净背景板 / IBK 风格抠像器。
- Select0r —— 带形状与边缘控制的色彩空间区域抠像器（RGB/ABI/HCI）。
- Matte Monitor —— 可视化所得遮罩的干净程度。