Remove Background
Remove the background from an input image using AI (Ideogram), leaving the foreground subject on transparency. Spends AI tokens per generation.
Category: AI Menu path: AI > Remove Background
Ports
| Port | Type | Direction | Description |
|---|---|---|---|
image_in | imageRgba16f | input | Required — the image whose background to remove. An Image Source, a prior generation, or any rendered node (captured via the engine). |
out | imageRgba16f | output | The foreground subject on a transparent background (transparent until you generate) |
Parameters
All parameters are managed by the Generate panel in Properties (not standard rows):
| Param | Type | Default | Description |
|---|---|---|---|
model | string | (first available) | Which AI model to use. Currently a single curated model (Ideogram Remove Background). |
resultPath | string | "" | Hidden — set automatically to the saved result under the project's generated/ folder. |
There is no prompt and no aspect ratio — the result is derived entirely from the input image, and its dimensions match the input.
How It Works
Wire an image into image_in and click Generate. Caddis captures that input (a direct file for an Image Source / prior generation, otherwise a render of the upstream node) and sends it to the Caddis server, which deducts the model's token cost from your balance and runs Ideogram's background removal. The result — the foreground subject cut out against transparency — is downloaded into your project's generated/ folder as a PNG, and the node loads it like an image source, so it composites and caches exactly like any other image. If generation fails, your tokens are automatically refunded.
The token cost is shown on the Generate button. You need a saved project (so generations have a home), an image wired into image_in, and enough tokens. If you're short, the Generate button opens the token top-up dialog.
The output carries an alpha channel — composite it straight over other layers, or feed its alpha into a matte.
Usage Examples
Basic: cut out a subject
Add an Image Source, wire it into a Remove Background node's image_in, and click Generate. The node outputs the subject on transparency, ready to composite over a new background.
Remove background from a rendered chain
Wire any rendered node (a processed image chain, a composited group) into image_in. Caddis captures its rendered output at the current frame and removes the background from that — no need to flatten to a file first.
Using the cutout as a matte
Route the result into a layer matte (Alpha) or into Mix as a mask to confine an effect to the subject.
Running low on tokens
If your balance is below the cost, the Generate button becomes "Get tokens · N more" and opens the top-up dialog — the server never charges or fails a generation you can't afford.
Tips
- Token cost is per generation and is shown on the button — re-running spends again.
- Generations live in your project's
generated/folder; they travel with the project. - The node shows transparent until you generate, so an empty Remove Background won't break a comp.
- Import to Assets adds the cutout to the asset manager; Delete removes the file.
Related Nodes
- GenerateDepth — Generate a depth map from an input image (AI / tokens)
- GenerateImage — Generate or edit an image from a text prompt (AI / tokens)
- ImageSource — Load a still image from disk (no AI / no tokens)