Documentation Index
Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
Use this file to discover all available pages before exploring further.
This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub
Overview
Edit a single image with Beeble SwitchX. This node can switch anything in the scene (background, lighting, costume) while preserving the original subject’s pixels. Provide a reference image and/or text prompt to describe the new look. Maximum resolution is approximately 2.77 megapixels.Inputs
| Parameter | Data Type | Required | Range | Description |
|---|---|---|---|---|
image | IMAGE | Yes | - | The source image to edit. |
prompt | STRING | Yes | - | A text description of the desired new look (e.g., “a knight in shining armor”). |
alpha_mode | COMBO | Yes | "select""fill""custom" | How to handle the alpha matte. “select” uses a keyframe to select the subject, “fill” replaces the entire image without a separate matte, “custom” uses a user-provided mask. |
max_resolution | COMBO | Yes | "1080p""720p" | The maximum resolution for the output image. Higher resolution costs more credits. |
seed | INT | Yes | - | A seed value for reproducibility. |
reference_image | IMAGE | No | - | An optional reference image to guide the style or appearance of the new scene elements. |
alpha_mode: When alpha_mode is set to "select", you must also provide an alpha_keyframe (a keyframe image used to select the subject). When set to "custom", you must provide an alpha_mask (a user-created mask). When set to "fill", no alpha input is needed.
Outputs
| Output Name | Data Type | Description |
|---|---|---|
image | IMAGE | The edited image with the scene elements switched. |
alpha | MASK | The alpha matte used by Beeble. Empty for “fill” mode, which has no separate matte. |
Source fingerprint (SHA-256):
41f23435686626e3ade28708fcb1da192ded347b210080ee9b17834ea8b727fb