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

# Beeble SwitchX Partner Nodes ComfyUI Official Examples

> This guide explains how to use Beeble SwitchX Partner Nodes in ComfyUI for AI-powered image and video relighting and environment editing

The [Beeble SwitchX](/built-in-nodes/BeebleSwitchXImageEdit) Partner Nodes allow you to transform the environment, lighting, and style of existing images and videos while preserving the original subject. Upload a character or subject image along with a reference environment, and SwitchX composites your subject into the new scene with realistic lighting and shadows.

In this guide, we'll show you how to use the Image Edit and Video Edit workflows.

<Tip>
  To use the Partner Nodes, you need to ensure that you are logged in properly and using a permitted network environment. Please refer to the [Partner Nodes Overview](/tutorials/partner-nodes/overview) section of the documentation to understand the specific requirements for using the Partner Nodes.
</Tip>

<Tip>
  <Tabs>
    <Tab title="Portable or self deployed users">
      Make sure your ComfyUI is updated.

      * [Download ComfyUI](https://www.comfy.org/download)
      * [Update Guide](/installation/update_comfyui)

      Workflows in this guide can be found in the [Workflow Templates](/interface/features/template).
      If you can't find them in the template, your ComfyUI may be outdated. (Desktop version's update will delay sometime)

      If nodes are missing when loading a workflow, possible reasons:

      1. You are not using the latest ComfyUI version (Nightly version)
      2. Some nodes failed to import at startup
    </Tab>

    <Tab title="Desktop or Cloud users">
      * The Desktop is base on ComfyUI stable release, it will auto-update when there is a new Desktop stable release available.
      * [Cloud](https://cloud.comfy.org) will update after ComfyUI stable release.

      So, if you find any core node missing in this document, it might be because the new core nodes have not yet been released in the latest stable version. Please wait for the next stable release.
    </Tab>
  </Tabs>
</Tip>

## Beeble SwitchX: Image Edit

Replace the background environment and relight your subject with a reference image.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_beeble_switchx_image_edit-1.webp" alt="Beeble SwitchX Image Edit Workflow" />

<Card title="Run in Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=api_beeble_switchx_image_edit&utm_source=docs&utm_medium=referral&utm_campaign=beeble_switchx_img">
  Open in Comfy Cloud
</Card>

<Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_beeble_switchx_image_edit.json">
  Download JSON or search "Beeble SwitchX: Image Edit" in Template Library
</Card>

### How It Works

This workflow takes two input images:

* **Subject image** — your character or main subject (with background)
* **Reference environment** — the new scene, lighting, or style you want to apply

The node generates an output where the subject is naturally composited into the new environment with proper lighting, shadows, and perspective.

### Steps to Run

1. **Upload subject image** — use the first **LoadImage** node to load your subject image (e.g., a person wearing headphones)
2. **Upload reference image** — use the second **LoadImage** node to load the target environment or style
3. **Enter your prompt** — describe the scene in the **BeebleSwitchXImageEdit** node
4. **Set resolution** — choose output resolution
5. **Adjust seed** — modify the seed for different results
6. **Click Queue** — press `Ctrl+Enter` to generate
7. **View results** — the edited image appears in **SaveImage**, and a masked cutout is saved separately

### Node Parameters

| Parameter    | Description                              |
| ------------ | ---------------------------------------- |
| `prompt`     | Description of the scene and environment |
| `resolution` | Output resolution (e.g., 720p)           |
| `seed`       | Random seed for reproducible results     |

## Beeble SwitchX: Video Edit

Apply environment relighting to a video while preserving the original motion and unmasked regions.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_beeble_switchx_video_edit-1.webp" alt="Beeble SwitchX Video Edit Workflow" />

<Card title="Run in Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=api_beeble_switchx_video_edit&utm_source=docs&utm_medium=referral&utm_campaign=beeble_switchx_vid">
  Open in Comfy Cloud
</Card>

<Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_beeble_switchx_video_edit.json">
  Download JSON or search "Beeble SwitchX: Video Edit" in Template Library
</Card>

### How It Works

This workflow takes a source video and a reference image, then applies the reference lighting and environment to the masked subject regions in the video. Unmasked areas preserve the original pixels and motion. The workflow also generates an alpha matte for easy compositing.

### Steps to Run

1. **Upload source video** — use the **LoadVideo** node to load your input video
2. **Upload reference image** — use the **LoadImage** node to load the target environment/style
3. **Set video range** — the **Video Slice** node controls which frames to process (start, end, inclusive)
4. **Enter your prompt** — describe the desired environment and lighting in the **BeebleSwitchXVideoEdit** node
5. **Set resolution** — choose output resolution
6. **Adjust seed** — modify the seed for different results
7. **Click Queue** — press `Ctrl+Enter`
8. **View results** — the edited video is saved, and a separate alpha matte video is generated for compositing

### Outputs

| Output                         | Description                                                             |
| ------------------------------ | ----------------------------------------------------------------------- |
| **Edited video** (`SaveVideo`) | The final video with new environment/lighting applied to masked regions |
| **Alpha matte** (`SaveVideo`)  | A separate alpha video for compositing the edited regions               |