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	Description	Data Type	Required	Range
`video`	The input video to edit. Maximum 240 frames, maximum ~2.77 megapixels per frame.	VIDEO	Yes	N/A
`prompt`	A text description of the desired new look for the scene.	STRING	Yes	N/A
`alpha_mode`	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.	COMBO	Yes	`"fill"` `"select"` `"custom"`
`max_resolution`	The maximum resolution for the output video (default: “1080p”).	COMBO	Yes	`"720p"` `"1080p"`
`seed`	A seed value for reproducibility. Using the same seed with the same inputs will produce the same result.	INT	Yes	0 to 2147483647
`reference_image`	An optional reference image that describes the desired new look for the scene.	IMAGE	No	N/A

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	Description	Data Type
`video`	The edited video with the scene changes applied.	VIDEO
`alpha`	The alpha matte used by Beeble. This is empty for “fill” mode, which has no separate matte.	VIDEO

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): e2d67b037863f024f42c97943ec0d2daf32b547b232a7dfedd6de398f4b7ba28

Nodes

BeebleSwitchXVideoEdit - ComfyUI Built-in Node Documentation

Beeble SwitchX Video Edit

Inputs

Alpha Mode Details

Outputs

​Beeble SwitchX Video Edit

​Inputs

​Alpha Mode Details

​Outputs

Beeble SwitchX Video Edit

Inputs

Alpha Mode Details

Outputs