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

# How to Use Ideogram 3.0 Replace Background in Raycast

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, no API key |

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

- Use Ideogram 3.0 Replace Background on the supplied perfume photo. Keep the bottle and request a dark stone surface, a charcoal wall, and soft light from the right. Turn prompt expansion off.
- Use Ideogram 3.0 Replace Background on this portrait. Replace the surroundings with a plain light gray studio wall and soft daylight. Keep the background description simple.
- Use Ideogram 3.0 Replace Background on the supplied sneaker photo. Try a dry concrete plaza in overcast daylight, with distant buildings softly out of focus.
- Use Ideogram 3.0 Replace Background on this coffee maker photo. Make two separate images: one with a plain studio setting and one with a quiet kitchen setting. Keep the descriptions below 100 words each.
- Use Ideogram 3.0 Replace Background on the supplied handbag photo. Request a plain taupe wall and a matte stone surface. Disable prompt expansion and keep the scene sparse.

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

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

### Use the Raycast connector

1. **Install the server**: In Raycast run Install MCP Server. Name it Spiral, set Transport to HTTP, paste this URL and keep OAuth Type on Dynamic:

```text
https://api.spiral.ai/mcp
```

2. **Sign in to Spiral and approve**: Spiral opens in your browser: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Raycast never sees it, and you can remove it under Settings › Connected apps in the console.

### Use the Spiral skill

1. **Send Raycast 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 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: Raycast finds Ideogram 3.0 Replace Background on Spiral, shows the price and runs it.

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

## 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 Raycast?

Explore new settings for an existing photo by describing the scene in conversation. A chat app can help refine the background brief for Ideogram 3.0 Replace Background and compare the results with your original idea.

### 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 Raycast guides](https://spiral.ai/integrations/raycast)

## 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)
- [dots](https://spiral.ai/integrations/dots/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)
- [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 Raycast guides

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

## Questions about Ideogram 3.0 Replace Background in Raycast

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

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

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

$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 Raycast plan is separate.

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

No. Spiral runs Ideogram 3.0 Replace Background on its own fal account. You sign in to Spiral once and never paste a key.

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

About two minutes: install the server, then sign in to Spiral and approve.

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

Ideogram 3.0 Replace Background runs in the background. Raycast 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.

