> ## Documentation Index
> Fetch the complete documentation index at: https://comfytv.org/llms.txt
> Use this file to discover all available pages before exploring further.
# 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` 时使用的背景。
## 输出
| 输出 | 类型 | 含义 |
| --------- | --------------- | ------------- |
| **video** | `COMFYTV_VIDEO` | 按所选输出形式的抠像结果。 |
## 提示
* 做亮度抠像时，先设 `mode=luminance`，把 `center` 设在分界处，再放大容差/柔度直到遮罩满意。
* 接入侧输入会切换到完整渲染模式；不接则保持可实时预览的抠像。
* 要与原生 ComfyUI 节点互通，请插入 **Bridge**。见 [bridges.md](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)。
## 相关节点
* **Chroma Key** —— 更简单的单色抠像。
* **PIK Keyer** —— 应对最难幕布的干净背景板 / IBK 风格抠像器。
* **Select0r** —— 带形状与边缘控制的色彩空间区域抠像器（RGB/ABI/HCI）。
* **Matte Monitor** —— 可视化所得遮罩的干净程度。