> ## 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.

# BeebleSwitchXImageEdit - ComfyUI Built-in Node Documentation

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

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/en.md)

## 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"`<br />`"fill"`<br />`"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"`<br />`"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.                                                                                       |

**Note on `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`