Nodes/ComfyUI/Beeble SwitchX Video Edit
ComfyUI Node Runs on cloud

Beeble SwitchX Video Edit

Swap the world around a subject, keep the subject's pixels

By Comfy-Org·Created 4 years ago·Updated about 10 hours ago· 130,663
Beeble SwitchX Video Edit
  • video
  • reference_image
  • video
  • alpha
prompt
alpha_mode
max_resolution1080p
seed0

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.

Categorypartner/video/Beeble

Inputs (6)

NameTypeDefaultDescription
videoVIDEO
promptSTRINGText description of the desired output (max 2000 chars). At least one of 'prompt' or 'reference_image' is required.
alpha_modeCOMBOControls 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_resolutionCOMBO1080pMaximum output resolution.
seedINT00–2147483647Seed controls whether the node should re-run; results are non-deterministic regardless of seed.
reference_imageoptIMAGEReference image whose look (background, lighting, costume) the result should adopt. At least one of 'reference_image' or 'prompt' is required.

Outputs (2)

NameTypeDescription
videoVIDEO
alphaVIDEOThe alpha matte Beeble used. Empty for 'fill' mode, which has no separate matte.