Beeble Start Video Generation Test

The video sibling of the Start Image node, with one extra knob. Beeble Start Video Generation Test sends a source video URI plus a prompt to Beeble's SwitchX API, kicks off a generation, and returns a job_id. Video jobs are the expensive ones in this API - a clip takes minutes and costs real money - so being able to start one, verify the job_id looks sane, and then poll it separately is genuinely useful for debugging before you automate.

The production Beeble SwitchX Video node does the full upload → start → wait → download chain in one go. This test node only fires the request. It's for the cases where you want to confirm the job actually started and inspect the raw response (via status_json) without committing your whole workflow to sitting on it.

How it works

POST /v1/switchx/generations with generation_type: "video" and the same strict validation as the image node: source_uri required, at least one of prompt/reference_image_uri, select mode needs an alpha_uri, and max_resolution is 720 or 1080.

The one video-specific addition is alpha_keyframe_index (INT, default 0, must be ≥ 0). In select mode, video alpha needs a reference frame: this is the frame of the source clip whose mask defines the alpha matte. Set it to the frame where your subject is most clearly separated, not necessarily frame zero.

Inputs and outputs

• source_uri (STRING) - the uploaded clip's Beeble URI (from Upload Video Test).
• alpha_mode - auto / fill / select (the video schema drops custom; that one lives in the production node where you can supply an alpha_video).
• prompt (STRING) - the edit prompt.
• seed (INT, default 0) - vary the result.
• max_resolution (720 / 1080).
• alpha_keyframe_index (INT, ≥ 0) - which frame's mask drives select mode.
• reference_image_uri / alpha_uri (optional) - reference and mask URIs.
• job_id (STRING) and status_json (STRING) - feed job_id into Poll/Wait Job Test.

Installing

cd ComfyUI/custom_nodes
git clone https://github.com/albert999-pixel/comfyui-beeble-switchx.git

Or search Beeble in ComfyUI Manager, restart, and set BEEBLE_API_KEY. No extra dependencies, no models to download - Beeble runs the compute, which is also why each start is a metered call and your clip leaves your machine. Same security picture as every API-wrapper pack: keep the key out of the workflow JSON.

Common issues

• Same validation errors as the image node - missing source_uri, empty prompt and reference, or alpha_uri missing in select mode.
• alpha_keyframe_index must be ≥ 0 - the field enforces it, but if you're wiring it from another node a negative value errors.
• Wrong region selected - you picked the frame where your subject is occluded; re-export the mask at a better keyframe and re-upload.
• 401 - key problem; validate with Account Info Test first.