Beeble Start Image Generation Test

This is the node that actually spends your Beeble credits. Beeble Start Image Generation Test takes a source image URI plus a prompt (and optional reference), tells Beeble's SwitchX API to start generating, and returns a job_id - the token you then hand to the Poll and Wait test nodes to chase the job to completion.

The whole point of this node is that it only starts the job. It doesn't wait, it doesn't poll, it doesn't download. The production Beeble SwitchX Image node chains all of that automatically; this one exists so you can watch each step land separately - and so you can start a job, go make a coffee, and come back to a job_id that's still valid hours later. Job IDs don't expire while the job is running.

How it works

The node POSTs to /v1/switchx/generations with generation_type: "image" and the fields below, then returns the id from the response as your job_id. The API is picky about a few things, and the code validates them before any call:

• source_uri is required - paste the beeble_uri from the Upload Image Test node.
• You must provide either a prompt or a reference_image_uri, or it errors.
• select and custom alpha modes require an alpha_uri - the mask must already be uploaded (or use the auto/fill modes, which don't need one).
• max_resolution is 720 or 1080, nothing else.

The inputs that matter

• source_uri (STRING) - your uploaded image's Beeble URI.
• alpha_mode - auto detects the subject automatically, fill keeps the original scene, select/custom use your uploaded mask.
• prompt (STRING) - the edit prompt.
• seed (INT, default 0) - change it to vary results.
• max_resolution (720 / 1080) - how big Beeble will render.
• reference_image_uri / alpha_uri (optional STRINGs) - the reference image and the alpha matte, if the mode needs them.
• job_id (STRING) and status_json (STRING) - the outputs. job_id feeds the Poll/Wait nodes.

Installing and key setup

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 (.env, env var, or ComfyUI Desktop env-variables). No extra Python deps, no models - this pack is a thin HTTP client for Beeble's paid cloud, so every run costs money and your prompt and image leave the machine. That's the deal with the whole pack, worth repeating here.

Common issues

• "At least one of prompt or reference_image_uri must be provided" - you left both empty.
• "alpha_uri is required when alpha_mode is select or custom" - connect an uploaded mask URI or switch modes.
• 401 - key problem; verify with Account Info Test before burning attempts.
• Network error after retries - two retries happened and failed; it's your connection, and the job was never started, so no credit charged.