Beeble SwitchX Video Edit
Swap the world around a subject, keep the subject's pixels
- video
- reference_image
- video
- alpha
Beeble is the VFX company best known for SwitchLight, an inverse-rendering pipeline that turns ordinary footage into PBR material maps for relighting. SwitchX is its successor idea, and it's a wild one: instead of just relighting, it switches anything in the scene - background, lighting, costume - while preserving the original subject's pixels and motion. This node is SwitchX's video edit API, built into ComfyUI core as a partner/video node. No install, nothing runs locally; the edit happens on Beeble's servers through Comfy's proxy, billed per render (the price badge prices per 30 frames) from your Comfy account.
The core loop is simple: video in, plus at least one of prompt (max 2000 chars) or reference_image - describe the new look, or show it, or both. "Turn the alley into a rainy neon street" from text, or "make it look like image2" from a reference. Because the subject's actual pixels are preserved rather than re-generated, this is a pixel-faithful edit - the person doesn't drift, the motion doesn't re-roll. That's the differentiator, and it's why the tooltip says "switches" rather than "regenerates."
The control that gives this node its depth is alpha_mode, a dynamic combo deciding what gets kept versus regenerated. auto isolates the main subject automatically - the default and the one to start with. fill regenerates the entire frame while preserving geometry, for when you want to change everything including the subject's look. select takes a first-frame keyframe mask and propagates it across the clip, for when auto's isolation isn't quite right. And custom accepts a per-frame alpha matte (connect a MASK output from SAM3_TrackToMask or similar) when you need frame-level control. The different modes unlock different quality/effort tradeoffs, and the alpha output - a second VIDEO - shows you the matte Beeble used, so you can see exactly what it kept. It's empty in fill mode, which regenerates without a separate matte.
Hard limits to plan around: max 240 frames per clip, and roughly 2.77MP per frame. The node downscales your source to fit the pixel budget rather than failing, so a 4K 30-second clip won't error - it'll just come back at reduced resolution. max_resolution (1080p default, or 720p) is your other quality lever, and it directly shapes the price.
Honest positioning: this is the node that finally makes "keep the performance, change everything else" reliable, and the alpha output is genuinely useful for compositing. It's newer - Beeble's SwitchX nodes landed in core in late May 2026 - and it's priced like the fancy VFX tool it is, so draft at 720p with short clips, confirm the keep-vs-regenerate balance, then spend on the final render. Your source video is uploaded to Beeble's servers, so keep that in mind for sensitive footage. If you've ever wished a video edit could be surgical instead of a re-roll, this is the closest thing in core.
Inputs (6)
| Name | Type | Default | Description |
|---|---|---|---|
| video | VIDEO | — | |
| prompt | STRING | Text description of the desired output (max 2000 chars). At least one of 'prompt' or 'reference_image' is required. | |
| alpha_mode | COMBO | Controls how SwitchX decides what to keep vs. regenerate. 'auto' isolates the main subject automatically. 'fill' regenerates the entire frame while preserving geometry. 'select' propagates a first-frame keyframe across the clip. 'custom' uses a per-frame alpha matte you provide. | |
| max_resolution | COMBO | 1080p | Maximum output resolution. |
| seed | INT | 00–2147483647 | Seed controls whether the node should re-run; results are non-deterministic regardless of seed. |
| reference_imageopt | IMAGE | Reference image whose look (background, lighting, costume) the result should adopt. At least one of 'reference_image' or 'prompt' is required. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| video | VIDEO | — |
| alpha | VIDEO | The alpha matte Beeble used. Empty for 'fill' mode, which has no separate matte. |