内置节点参考
BeebleSwitchXVideoEdit - ComfyUI Built-in Node Documentation
Complete documentation for the BeebleSwitchXVideoEdit node in ComfyUI. Learn its inputs, outputs, parameters and usage.
使用 Beeble SwitchX 编辑视频。此节点可以切换场景中的任何内容（背景、光照、服装），同时保留原始主体的像素和运动。提供参考图像和/或文本提示来描述新的外观。
## 输入
| 参数 | 描述 | 数据类型 | 是否必需 | 范围 |
|---|---|---|---|---|
视频 |
要编辑的输入视频。最多 240 帧，每帧最多约 277 万像素。 | VIDEO | 是 | 不适用 |
提示词 |
场景所需新外观的文本描述。 | STRING | 是 | 不适用 |
alpha_mode |
Alpha 遮罩模式。"fill"模式没有单独的遮罩，填充整个帧。"select"模式使用单个关键帧图像来定义要编辑的区域。"custom"模式使用完整的 Alpha 视频逐帧定义要编辑的区域。 | COMBO | 是 | "fill" |
"select" "custom" | | 最大分辨率 | 输出视频的最大分辨率（默认值："1080p"）。 | COMBO | 是 | "720p" "1080p" | | 种子 | 用于可复现性的种子值。使用相同的种子和相同的输入将产生相同的结果。 | INT | 是 | 0 到 2147483647 | | 参考图像 | 描述场景所需新外观的可选参考图像。 | IMAGE | 否 | 不适用 |
Alpha 模式详情
alpha_mode 参数控制视频的哪些部分被编辑：
- fill：编辑整个视频帧。不生成单独的 Alpha 遮罩。
- select：您提供一个定义要编辑区域的单个关键帧图像。节点将使用此图像来确定要更改视频的哪些部分。
- custom：您提供一个完整的 Alpha 视频，逐帧定义要编辑的区域。这使您可以精确控制每帧的哪些部分被编辑。
使用 select 模式时，您必须提供 alpha_keyframe 图像。使用 custom 模式时，您必须提供 alpha_mask 视频。
## 输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
视频 |
应用了场景更改后的编辑视频。 | VIDEO |
alpha |
Beeble 使用的 Alpha 遮罩。对于没有单独遮罩的"fill"模式，此输出为空。 | VIDEO |
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑
Source fingerprint (SHA-256): e2d67b037863f024f42c97943ec0d2daf32b547b232a7dfedd6de398f4b7ba28
官方原文
本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。