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

# How to Use Bria Background Replace in Hermes

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 Hermes

- Every Monday, use Bria Background Replace on newly supplied product photos to prepare a kitchen-counter backdrop candidate for each. Write the scene descriptions in English, match each photo's lighting, and collect the originals and results in a review gallery.
- At the start of each month, use Bria Background Replace to prepare seasonal backdrop candidates for the supplied candle photos. Keep the products as the subjects and record the scene description and seed with each result.
- Each Friday, use Bria Background Replace with the newly supplied product photos and approved scene reference. Prepare reference-guided background candidates and collect them for review of subject edges, scale, and perspective.
- Each morning, use Bria Background Replace on new portrait submissions to prepare an office-backdrop candidate. Match the existing light direction and place each original beside its result for review.
- Every Wednesday, use Bria Background Replace to prepare studio, home, and outdoor background tests for the supplied featured-product photo. Keep the source fixed and summarize the three scene choices alongside their images.

## How to set up Bria Background Replace in Hermes

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

### Use the Spiral skill

1. **Send Hermes 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. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### 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: Hermes finds Bria Background Replace on Spiral, shows the price and runs it.

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

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

Prepare recurring batches of campaign and catalog background candidates with Bria Background Replace. Apply a shared scene brief to supplied photos and keep the results available for visual review.

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

## 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)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/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)
- [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 Hermes guides

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

## Questions about Bria Background Replace in Hermes

**Can Hermes use Bria Background Replace?**

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

**How much does Bria Background Replace cost in Hermes?**

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

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

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 Hermes?**

About two minutes: add the server and sign in, then check it.

**Does Hermes wait while Bria Background Replace runs?**

Bria Background Replace runs in the background. Hermes 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.

