[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [Ideogram 3.0 Replace Background](https://spiral.ai/integrations/dots/ideogram-3-0-replace-background)

# How to Use Ideogram 3.0 Replace Background in dots

Ideogram 3.0 Replace Background puts an existing foreground subject into a new setting described in words. Use it for product scenes, portrait backdrops, and campaign images when the subject should stay and the surroundings should change.

|  |  |
| --- | --- |
| Model | Ideogram 3.0 Replace Background |
| Available through | fal |
| Category | Image |
| Price | $0.039 per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Ideogram 3.0 Replace Background in dots

- Each Monday, use Ideogram 3.0 Replace Background on newly approved product photos in the image queue. Request a pale gray studio wall, a matte surface, and soft side lighting. Return the results with their source images for review.
- Every Friday, use Ideogram 3.0 Replace Background on the week's approved coffee product photos. Request a quiet kitchen counter with a plain wall and morning daylight. Keep prompt expansion off.
- At the start of each month, use Ideogram 3.0 Replace Background on the approved campaign product photo. Make separate spring garden, autumn interior, and winter window concepts, using one focused scene per request.
- Each weekday, use Ideogram 3.0 Replace Background on newly approved staff portraits in the portrait queue. Request a plain light gray studio background with soft daylight. Return drafts for review.
- Every Tuesday, use Ideogram 3.0 Replace Background on the approved furniture campaign image. Compare a plain interior wall with a reading nook, keeping the seed and other settings fixed. Return both concepts alongside the source.

## How to set up Ideogram 3.0 Replace Background in dots

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send dots this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Ideogram 3.0 Replace Background**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/ideogram/v3/replace-background",
    "input": {
      "prompt": "A beautiful sunset over mountains that writes Ideogram v3 in fal.ai",
      "image_url": "https://v3.fal.media/files/rabbit/F6dvKPFL9VzKiM8asJOgm_MJj6yUB6rGjTsv_1YHIcA_image.webp"
    }
  }'
```

Then paste one of the prompts above: dots finds Ideogram 3.0 Replace Background on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/dots

## Ideogram 3.0 Replace Background tools and prices

- [Ideogram Replace Background](https://spiral.ai/tools/fal/fal-ai/ideogram/v3/replace-background) (fal): $0.039 per image with TURBO, $0.078 with BALANCED (the default), $0.117 with QUALITY.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_urls |  | — | 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 | TURBO, BALANCED, QUALITY | BALANCED | The rendering speed to use. |
| color_palette |  | — | 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) |
| style_codes |  | — | A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style |
| style | AUTO, GENERAL, REALISTIC, DESIGN | — | The style type to generate with. Cannot be used with style_codes. |
| expand_prompt |  | true | Determine if MagicPrompt should be used in generating the request or not. |

## What can you do with Ideogram 3.0 Replace Background in dots?

Prepare recurring background concepts from approved source photos for editorial review. A scheduled agent can use Ideogram 3.0 Replace Background to apply a consistent scene brief as new images arrive.

### Product listing scenes

Place an existing product photo against a simple studio background for a listing image. Review the result against the source before using it.

### Seasonal campaign images

Use an approved product photo to explore spring gardens, autumn interiors, or winter window scenes around the same foreground subject.

### Portrait backdrops

Replace a distracting setting behind an existing portrait with a plain studio wall or a softly blurred office.

### Product lifestyle concepts

Try a kitchen setting behind a coffee maker or a reading nook behind a chair. Start with a source photo whose subject placement suits the proposed scene.

### Advertising background tests

Compare restrained indoor and outdoor settings around one approved foreground image. Keep the description focused on the background being tested.

### Website photography drafts

Explore alternative surroundings for existing product or team photography before placing the selected images in a page design.

### Resale photo cleanup

Replace clutter behind a photographed item with a plain wall and simple floor. Compare the item with the original photo before publishing the result.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All dots guides](https://spiral.ai/integrations/dots)

## Ideogram 3.0 Replace Background in other agents

- [Amp](https://spiral.ai/integrations/amp/ideogram-3-0-replace-background)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/ideogram-3-0-replace-background)
- [Claude](https://spiral.ai/integrations/claude-desktop/ideogram-3-0-replace-background)
- [Claude Code](https://spiral.ai/integrations/claude-code/ideogram-3-0-replace-background)
- [Cline](https://spiral.ai/integrations/cline/ideogram-3-0-replace-background)
- [Codex](https://spiral.ai/integrations/codex/ideogram-3-0-replace-background)
- [Cursor](https://spiral.ai/integrations/cursor/ideogram-3-0-replace-background)
- [Devin](https://spiral.ai/integrations/devin/ideogram-3-0-replace-background)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/ideogram-3-0-replace-background)
- [Gemini](https://spiral.ai/integrations/gemini/ideogram-3-0-replace-background)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/ideogram-3-0-replace-background)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/ideogram-3-0-replace-background)
- [goose](https://spiral.ai/integrations/goose/ideogram-3-0-replace-background)
- [Grok](https://spiral.ai/integrations/grok/ideogram-3-0-replace-background)
- [Grok Build](https://spiral.ai/integrations/grok-build/ideogram-3-0-replace-background)
- [Hermes](https://spiral.ai/integrations/hermes/ideogram-3-0-replace-background)
- [Instinct](https://spiral.ai/integrations/instinct/ideogram-3-0-replace-background)
- [Manus](https://spiral.ai/integrations/manus/ideogram-3-0-replace-background)
- [Muse](https://spiral.ai/integrations/muse/ideogram-3-0-replace-background)
- [Muse Code](https://spiral.ai/integrations/muse-code/ideogram-3-0-replace-background)
- [n8n](https://spiral.ai/integrations/n8n/ideogram-3-0-replace-background)
- [Notion](https://spiral.ai/integrations/notion/ideogram-3-0-replace-background)
- [OpenClaw](https://spiral.ai/integrations/openclaw/ideogram-3-0-replace-background)
- [opencode](https://spiral.ai/integrations/opencode/ideogram-3-0-replace-background)
- [Perplexity](https://spiral.ai/integrations/perplexity/ideogram-3-0-replace-background)
- [Raycast](https://spiral.ai/integrations/raycast/ideogram-3-0-replace-background)
- [VS Code](https://spiral.ai/integrations/vscode/ideogram-3-0-replace-background)
- [Windsurf](https://spiral.ai/integrations/windsurf/ideogram-3-0-replace-background)
- [Zapier](https://spiral.ai/integrations/zapier/ideogram-3-0-replace-background)

## More dots guides

- [Ideogram 3.0 Remix](https://spiral.ai/integrations/dots/ideogram-3-0-remix)
- [Ideogram 3.0 Text to Image](https://spiral.ai/integrations/dots/ideogram-3-0-text-to-image)
- [Ideogram 3.0 Reframe](https://spiral.ai/integrations/dots/ideogram-3-0-reframe)
- [Ideogram 3.0 Transparent](https://spiral.ai/integrations/dots/ideogram-3-0-transparent)
- [Ideogram 3.0 Layerize Text](https://spiral.ai/integrations/dots/ideogram-3-0-layerize-text)
- [Ideogram 4 Tiling](https://spiral.ai/integrations/dots/ideogram-4-tiling)

## Questions about Ideogram 3.0 Replace Background in dots

**Can dots use Ideogram 3.0 Replace Background?**

Yes. Add Spiral to dots as an MCP server, and dots can find and run Ideogram 3.0 Replace Background like any built-in tool.

**How much does Ideogram 3.0 Replace Background cost in dots?**

$0.039 per image. Billed on `num_images`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.

**Do I need a fal account to use Ideogram 3.0 Replace Background in dots?**

You need no fal account. dots uses one Spiral API key for every tool, and Spiral runs Ideogram 3.0 Replace Background on its own fal account.

**How long does it take to set up Ideogram 3.0 Replace Background in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while Ideogram 3.0 Replace Background runs?**

Ideogram 3.0 Replace Background runs in the background. dots starts the run, checks on it and gives you the image when it's ready.

**What does Ideogram 3.0 Replace Background preserve?**

It identifies and keeps the foreground subject while generating new surroundings from your description. It fits tasks where the product or person should remain and the setting should change.

**Do I need to draw a mask?**

No. Ideogram 3.0 Replace Background detects the foreground subject automatically, so you do not need to paint the background selection.

**Does background replacement create a transparent cutout?**

Background replacement generates new surroundings from a prompt. Use background removal when the goal is an isolated subject on transparency.

**How long should my background prompt be?**

Keep it below about 150 words, roughly 200 tokens. Describe the intended setting clearly; Ideogram warns that 3.0 may weaken or ignore words beyond that length.

**Why did extra scenery appear?**

Vague or crowded descriptions leave details for Ideogram to invent, and Magic Prompt can add more. Simplify the scene and turn prompt expansion off when you want to test your exact wording.

