BeebleSwitchXImageEdit - ComfyUI Built-in Node Documentation

Complete documentation for the BeebleSwitchXImageEdit node in ComfyUI. Learn its inputs, outputs, parameters and usage.

​

## 概述

使用 Beeble SwitchX 编辑单张图像。此节点可以切换场景中的任何元素（背景、光照、服装），同时保留原始主体的像素。提供参考图像和/或文本提示来描述新的外观。最大分辨率约为 277 万像素。

​

## 输入

参数	描述	数据类型	是否必填	取值范围
图像	要编辑的源图像。	IMAGE	是	-
提示词	所需新外观的文本描述（例如：“身穿闪亮盔甲的骑士”）。	STRING	是	-
alpha_mode	处理 Alpha 遮罩的方式。“select” 使用关键帧选择主体，“fill” 替换整个图像而不使用独立遮罩，“custom” 使用用户提供的遮罩。	COMBO	是	"select" "fill" "custom"
最大分辨率	输出图像的最大分辨率。更高分辨率会消耗更多积分。	COMBO	是	"1080p" "720p"
种子	用于结果可复现的种子值。	INT	是	-
参考图像	可选的参考图像，用于引导新场景元素的风格或外观。	IMAGE	否	-

关于 alpha_mode 的说明： 当 alpha_mode 设置为 "select" 时，您还必须提供 alpha_keyframe（用于选择主体的关键帧图像）。当设置为 "custom" 时，您必须提供 alpha_mask（用户创建的遮罩）。当设置为 "fill" 时，无需提供 Alpha 输入。

​

## 输出

输出名称	描述	数据类型
图像	已切换场景元素的编辑后图像。	IMAGE
alpha	Beeble 使用的 Alpha 遮罩。对于 “fill” 模式，此输出为空，因为该模式没有独立遮罩。	MASK

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

---

Source fingerprint (SHA-256): 41f23435686626e3ade28708fcb1da192ded347b210080ee9b17834ea8b727fb