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