fal.ai · Replace background
Ideogram 3
Ideogram 3, replace background, served by fal.ai. The OpenAPI schema for the fal-ai/ideogram/v3/replace-background queue. Price: $0.03 per image with TURBO, $0.06 with BALANCED (default), $0.09 with QUALITY.
Usage based fal.aiImagefal/ideogram-v3-replace-backgroundListed
Activation pending; your agent will see it as unavailable until then.
Use this tool with your agent
Give this to your agent
Use my connected Agentik MCP server. I want to use the tool fal/ideogram-v3-replace-background (Ideogram 3, replace background). Call inspect_tool with {"tool_id": "fal/ideogram-v3-replace-background"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "fal/ideogram-v3-replace-background" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If the tool is unavailable, say so and use discover_tools to propose an alternative.Show the prompt
Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
prompt | string | Yes | Cyber punk city with neon lights and skyscrappers |
style | string | No | The style type to generate with. Cannot be used with style_codes. Options: AUTO, GENERAL, REALISTIC, DESIGN. |
image_url | string | Yes | The image URL whose background needs to be replaced |
color_palette | object | No | A color palette for generation, must EITHER be specified via one of the presets (name) or explicitly via hexadecimal representations of the color with optional weights (members) |
expand_prompt | boolean | No | Determine if MagicPrompt should be used in generating the request or not. |
image_urls | string[] | No | A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format |
rendering_speed | string | No | The rendering speed to use. Options: TURBO, BALANCED, QUALITY. |
style_codes | string[] | No | A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style |
seed | integer | No | Seed for the random number generator |
num_images | integer | No | Number of images to generate. |
style_preset | string | No | Style preset for generation. The chosen style preset will guide the generation. Options: 80S_ILLUSTRATION, 90S_NOSTALGIA, ABSTRACT_ORGANIC, ANALOG_NOSTALGIA, ART_BRUT, ART_DECO, ART_POSTER, AURA, AVANT_GARDE, BAUHAUS, BLUEPRINT, BLURRY_MOTION. |
How your agent calls it
First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:
{
"tool_id": "fal/ideogram-v3-replace-background",
"input": {
"prompt": "a plain wooden desk background",
"image_url": "https://storage.googleapis.com/falserverless/example_outputs/nano-banana-2-t2i-output.png",
"rendering_speed": "TURBO",
"num_images": 1
}
}Price and billing
- Price
- Usage based
- Model
- Per unit
- Detail
- The provider’s price, with no markup. Billed for measured usage.
- The provider’s price, 0% markup.
- One prepaid balance for every provider; your agent sees the price before it runs.
- Pay for measured usage; unused reservations are released.