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

# BeebleSwitchXVideoEdit - ComfyUI Built-in Node Documentation

> Complete documentation for the BeebleSwitchXVideoEdit 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/BeebleSwitchXVideoEdit/en.md)

# Beeble SwitchX Video Edit

Edit a video with Beeble SwitchX. This node can switch anything in the scene (background, lighting, costume) while preserving the original subject's pixels and motion. Provide a reference image and/or text prompt to describe the new look.

## Inputs

| Parameter         | Data Type | Required | Range                                    | Description                                                                                                                                                                                                                                 |
| ----------------- | --------- | -------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `video`           | VIDEO     | Yes      | N/A                                      | The input video to edit. Maximum 240 frames, maximum \~2.77 megapixels per frame.                                                                                                                                                           |
| `prompt`          | STRING    | Yes      | N/A                                      | A text description of the desired new look for the scene.                                                                                                                                                                                   |
| `alpha_mode`      | COMBO     | Yes      | `"fill"`<br />`"select"`<br />`"custom"` | The alpha matte mode. "fill" mode has no separate matte and fills the entire frame. "select" mode uses a single keyframe image to define the area to edit. "custom" mode uses a full alpha video to define the area to edit frame by frame. |
| `max_resolution`  | COMBO     | Yes      | `"720p"`<br />`"1080p"`                  | The maximum resolution for the output video (default: "1080p").                                                                                                                                                                             |
| `seed`            | INT       | Yes      | 0 to 2147483647                          | A seed value for reproducibility. Using the same seed with the same inputs will produce the same result.                                                                                                                                    |
| `reference_image` | IMAGE     | No       | N/A                                      | An optional reference image that describes the desired new look for the scene.                                                                                                                                                              |

### Alpha Mode Details

The `alpha_mode` parameter controls which parts of the video are edited:

* **fill**: The entire video frame is edited. No separate alpha matte is produced.
* **select**: You provide a single keyframe image that defines the area to edit. The node will use this to determine which parts of the video to change.
* **custom**: You provide a full alpha video that defines the area to edit frame by frame. This gives you precise control over which parts of each frame are edited.

When using `select` mode, you must provide the `alpha_keyframe` image. When using `custom` mode, you must provide the `alpha_mask` video.

## Outputs

| Output Name | Data Type | Description                                                                                 |
| ----------- | --------- | ------------------------------------------------------------------------------------------- |
| `video`     | VIDEO     | The edited video with the scene changes applied.                                            |
| `alpha`     | VIDEO     | The alpha matte used by Beeble. This is empty for "fill" mode, which has no separate matte. |

***

**Source fingerprint (SHA-256):** `e2d67b037863f024f42c97943ec0d2daf32b547b232a7dfedd6de398f4b7ba28`