[Integrations](https://spiral.ai/integrations) › [Google Antigravity](https://spiral.ai/integrations/antigravity) › [Bria Background Replace](https://spiral.ai/integrations/antigravity/bria-background-replace)

# How to Use Bria Background Replace in Google Antigravity

Bria Background Replace puts an existing subject into a new setting for product photos, portraits, and campaign images. It focuses on replacing the backdrop while preserving the subject, with guidance from a written description or reference image.

|  |  |
| --- | --- |
| Model | Bria Background Replace |
| Available through | fal |
| Category | Image |
| Price | $0.052 per generation. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Bria Background Replace in Google Antigravity

- Use Bria Background Replace on the product photo in this project. Draft a 50 to 60 word English background description for a pale stone kitchen counter with soft window light matching the product, generate a candidate, and save it beside the original for review.
- Use Bria Background Replace to create three backdrop candidates from our existing hero product photo: a quiet studio, a home office, and a shaded patio. Keep the source fixed and build a local comparison page with the original and each result.
- Use Bria Background Replace with the project's product photo and campaign scene reference. Generate a reference-guided backdrop, save the result in the campaign assets directory, and show it alongside the source so I can inspect edges and perspective.
- Use Bria Background Replace on our team portrait asset to try a softly lit office backdrop. Match the background light to the portrait and create a before-and-after preview without replacing the original asset.
- Use Bria Background Replace to test a new backdrop for the project's catalog photo. Save the exact source, prompt, seed, settings, and returned dimensions in an asset manifest so we can reproduce the approved result.

## How to set up Bria Background Replace in Google Antigravity

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

### Use Spiral's MCP server

1. **Open the MCP config**: * Antigravity App: click Customizations, then Installed. In the MCP Servers section, click Copy Config File Path and open that file. * Antigravity IDE: click … at the top of the agent side panel, select MCP Servers, then Manage MCP Servers › View raw config. * Antigravity CLI: edit `~/.gemini/config/mcp_config.json`.

2. **Add the server**: Add Spiral under `mcpServers`:

```json
{
  "mcpServers": {
    "spiral": {
      "serverUrl": "https://api.spiral.ai/mcp"
    }
  }
}
```

3. **Sign in**: In the Antigravity App, open Customizations › Installed. Under MCP Servers, click Authenticate next to Spiral. Sign in to Spiral, pick the organization and click Authorize. Copy the authorization code the browser shows, paste it into Enter authorization code and click Submit. No API key.

### Use the Spiral skill

1. **Send Google Antigravity 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 Bria Background Replace**: 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/bria/background/replace",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/bria/bria_bg_replace_fg.jpg"
    }
  }'
```

Then paste one of the prompts above: Google Antigravity finds Bria Background Replace on Spiral, shows the price and runs it.

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

## Bria Background Replace tools and prices

- [Bria Background Replace](https://spiral.ai/tools/fal/fal-ai/bria/background/replace) (fal): $0.052 per generation. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| ref_image_url |  |  | The URL of the reference image to be used for generating the new background. Use "" to leave empty. Either ref_image_url or bg_prompt has to be provided but not both. If both ref_image_url and ref_image_file are provided, ref_image_url will be used. Accepted formats are jpeg, jpg, png, webp. |
| prompt |  | — | The prompt you would like to use to generate images. |
| negative_prompt |  |  | The negative prompt you would like to use to generate images. |
| refine_prompt |  | true | Whether to refine prompt |
| seed | 0 to 2147483647 | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |
| fast |  | true | Whether to use the fast model |

## What can you do with Bria Background Replace in Google Antigravity?

Turn project photography into candidate storefront, landing-page, and campaign assets with Bria Background Replace. Use the existing photos as sources, then compare the new settings against the project's visual brief.

### Product photos in everyday settings

Use Bria Background Replace to place an existing bottle, bag, or appliance against a relevant setting. Describe the surface and lighting so the scene suits the photographed product.

### Seasonal campaign images

Use Bria Background Replace to try autumn, winter, or summer backdrops around an existing product photo. Review the subject and background together before selecting an image.

### Portrait backdrops

Use Bria Background Replace to give a supplied portrait an office, studio, or outdoor setting. Request background lighting that matches the light already falling on the person.

### Reference-led campaign scenes

Use Bria Background Replace with a subject photo and a separate scene reference to guide the backdrop for a campaign. Check perspective and scale before approving the result.

### Background tests for ads

Use Bria Background Replace to compare the same product against a studio setting, a home interior, and an outdoor scene. Keep the source photo fixed to make the comparison useful.

### Storefront image refreshes

Use Bria Background Replace to refresh existing product photography with a shared backdrop brief. Review each result for subject edges, contact shadows, and visual consistency.

## Overview

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

## Bria Background Replace in other agents

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

## More Google Antigravity guides

- [Boogu Image](https://spiral.ai/integrations/antigravity/boogu-image)
- [Bria Creative Upscale](https://spiral.ai/integrations/antigravity/bria-creative-upscale)
- [Background Change](https://spiral.ai/integrations/antigravity/background-change)
- [Bria Embed Product](https://spiral.ai/integrations/antigravity/bria-embed-product)
- [Baby Version](https://spiral.ai/integrations/antigravity/baby-version)
- [Bria Eraser](https://spiral.ai/integrations/antigravity/bria-eraser)

## Questions about Bria Background Replace in Google Antigravity

**Can Google Antigravity use Bria Background Replace?**

Yes. Add Spiral to Google Antigravity as an MCP server, and Google Antigravity can find and run Bria Background Replace like any built-in tool.

**How much does Bria Background Replace cost in Google Antigravity?**

$0.052 per generation. 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 Google Antigravity plan is separate.

**Do I need a fal account to use Bria Background Replace in Google Antigravity?**

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

**How long does it take to set up Bria Background Replace in Google Antigravity?**

About two minutes: open the MCP config, then add the server, then sign in.

**Does Google Antigravity wait while Bria Background Replace runs?**

Bria Background Replace runs in the background. Google Antigravity starts the run, checks on it and gives you the image when it's ready.

**What is Bria Background Replace useful for?**

Use it to put an existing subject into a different setting: a product on a kitchen counter, a portrait against an office backdrop, or a campaign photo with seasonal scenery. Its focus is changing the background while preserving the subject.

**Can a photo guide the new background?**

Yes. A reference image can guide the background instead of a written description. Use a scene reference when showing the intended setting is easier than describing it.

**What language should I write prompts in?**

Write background descriptions in English using ordinary text. Bria documents English-only support and excludes special characters.

**How detailed should a background prompt be?**

For fast background generation, aim for about 50 to 60 words. Describe the setting, supporting surface, light, and shadows, and ask that they match the existing subject.

**How can I reproduce a result?**

Keep the source image, prompt, seed, and other settings unchanged. Reproduction also depends on using the same model version.

