> ## Documentation Index
> Fetch the complete documentation index at: https://comfytv.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Chroma Key（色度抠像）
> 一趟处理即可从绿幕/蓝幕素材中抠出主体，并自带溢色抑制。
## 这个节点做什么
Chroma Key（色度抠像）会从视频中去掉一块纯色背景（绿幕、蓝幕，或你自选的任意颜色），把它变成透明或遮罩。它的用法类似 After Effects 或 Premiere 里的快速色度抠像器：选好幕布颜色，调整判定为"背景"的颜色范围宽窄，柔化边缘，并清除渗到主体上的绿/蓝溢色。
输入与输出都是 `COMFYTV_VIDEO`。它带有 ▶ Run —— 抠像由 ffmpeg/PyAV 计算，因此在运行节点时才处理，而非实时。
## 何时使用
* 你在绿幕/蓝幕前拍了人物或产品，想把它放到新背景上。
* 你需要一个快速可靠的抠像，不必用到完整抠像器那么多控件。
* 你想得到一个遮罩（灰度蒙版），供下游合成或混合步骤使用。
## 参数
### key\_color
要去除的背景颜色，十六进制字符串。默认 `#00FF00`（纯绿）。请设为你实际的幕布颜色 —— 蓝幕用偏 `#0000FF` 的值，或从素材中吸取准确的绿色以获得更干净的抠像。
### similarity
一个像素的颜色要多接近 `key_color` 才算作背景。范围 `0.01`–`1.0`，默认 `0.1`。若残留幕布颜色就调高；若开始吃掉主体则调低。
### blend
边缘柔度 —— 阈值附近的像素从不透明渐变到透明的平滑程度。范围 `0.0`–`1.0`，默认 `0.05`。少量混合能让边缘更平滑不锯齿；过多则整条边发虚。
### despill\_mix
去除反射到主体上的残余幕布颜色（发丝和边缘上的绿/蓝溢色）的强度。范围 `0.0`–`1.0`，默认 `0.5`。边缘发绿就调高；肤色发灰就调低。
### despill\_expand
从抠像边缘向外扩大去溢色的作用区域，以处理更多渗色。范围 `0.0`–`1.0`，默认 `0.0`。当溢色蔓延到边缘之外时略微调高。
### output
节点输出的内容。`alpha`（默认）产生带真实透明通道的视频；`matte` 产生灰度蒙版（白=保留，黑=去除）。注意 `alpha` 输出需要带 VP9 编码器的 PyAV 构建；若报错，改用 `matte`。
## 输出
| 输出 | 类型 | 含义 |
| --------- | --------------- | --------------------------------- |
| **video** | `COMFYTV_VIDEO` | 抠像后的片段：透明（`alpha`）或灰度遮罩（`matte`）。 |
## 提示
* 若 `alpha` 输出因编码器报错，改用 `matte`，再在下游用 **Key Mix** 合成。
* 遇到困难抠像（打光不均、细发、运动模糊）请改用 **PIK Keyer** 或 **Keyer**，它们提供更精细的控制。
* 要与原生 ComfyUI 节点互通，请插入 **Bridge**。见 [bridges.md](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)。
## 相关节点
* **PIK Keyer** —— 基于图像（IBK 风格）的抠像器，带干净背景板和垃圾遮罩输入，应对更难的镜头。
* **Keyer** —— 亮度/色度抠像器，两侧的容差与柔度可独立调节。
* **Despill** —— 只需清除溢色时用的专用去溢色节点。
* **Key Mix** —— 用遮罩把抠出的前景合成到新背景上。