[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [Bria GenFill](https://spiral.ai/integrations/hermes/bria-genfill)

# How to Use Bria GenFill in Hermes

Bria GenFill adds or replaces objects inside a masked part of an existing image. Use it for targeted changes such as swapping a prop or adding seasonal details while working with the surrounding scene.

|  |  |
| --- | --- |
| Model | Bria GenFill |
| 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 GenFill in Hermes

- Every Monday, use Bria GenFill on the newly supplied campaign photos with prepared selections. Replace the selected prop with a small matte ceramic bowl, matching its scale, surface contact, and scene lighting. Collect the results for review.
- At the start of each month, use Bria GenFill on the supplied seasonal campaign photo. Add the month's approved decorative object inside the prepared selection, with a matching contact shadow, and present it for review.
- Each Friday, use Bria GenFill to make two prop concepts for each supplied room photo with a prepared selection: a terracotta vase and a brushed-metal vase. Keep the random seed fixed for each comparison.
- Each morning, use Bria GenFill on newly supplied cupcake photos with selected topping areas. Add one red cherry per photo, specifying realistic size and contact with the frosting. Collect the edited images for review.
- Every Wednesday, use Bria GenFill on the supplied product campaign photos and prepared selections. Replace the selected decoration with the approved regional prop, matching material, scale, and contact shadow. Group the results by campaign.

## How to set up Bria GenFill 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 GenFill**: 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/genfill",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/bria/bria_genfill_img.png",
      "mask_url": "https://storage.googleapis.com/falserverless/bria/bria_genfill_mask.png",
      "prompt": "A red delicious cherry"
    }
  }'
```

Then paste one of the prompts above: Hermes finds Bria GenFill on Spiral, shows the price and runs it.

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

## Bria GenFill tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| negative_prompt |  |  | The negative prompt you would like to use to generate images. |
| 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. |
| num_images | 1 to 4 | 1 | Number of Images to generate. |

## What can you do with Bria GenFill in Hermes?

Prepare recurring image edits from supplied photos and selected regions. An always-on agent can apply a seasonal brief or a consistent prop description, then collect the results for review.

### Product photo prop changes

Select a prop beside a product and replace it with a different object. For example, try a ceramic dish in place of a wooden tray.

### Seasonal campaign edits

Add a pumpkin, wrapped gift, or spring arrangement to a selected area of an existing campaign photo.

### Interior styling previews

Replace a vase or table decoration in a room photo to compare styling ideas before arranging a shoot.

### Food photo additions

Add a cherry or another garnish to a selected area of a food photo. Describe its size, surface contact, and shadow.

### Localized campaign details

Try a different decorative object in an existing campaign image to explore a regional creative brief.

### Website image revisions

Replace a distracting decorative object in an existing website photo with a simpler prop that suits the page.

### Material concept previews

Regenerate a selected object as ceramic, wood, or brushed metal to compare material directions in the same scene.

## Overview

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

## Bria GenFill in other agents

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

## More Hermes guides

- [Bria Fibo](https://spiral.ai/integrations/hermes/bria-fibo)
- [Bria GenFill v2](https://spiral.ai/integrations/hermes/bria-genfill-v2)
- [Bria Fast](https://spiral.ai/integrations/hermes/bria-fast)
- [Bria Guided Remove Background](https://spiral.ai/integrations/hermes/bria-guided-remove-background)
- [Bria FIBO Edit 1.5 Expand](https://spiral.ai/integrations/hermes/bria-fibo-edit-1-5-expand)
- [Bria HD](https://spiral.ai/integrations/hermes/bria-hd)

## Questions about Bria GenFill in Hermes

**Can Hermes use Bria GenFill?**

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

**How much does Bria GenFill 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 GenFill in Hermes?**

No. Spiral runs Bria GenFill 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 GenFill in Hermes?**

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

**Does Hermes wait while Bria GenFill runs?**

Bria GenFill runs in the background. Hermes starts the run, checks on it and gives you the image when it's ready.

**What is Bria GenFill useful for?**

Use Bria GenFill to add or replace an object within a selected part of an existing image. Practical examples include replacing a table prop, changing a decorative object, or adding seasonal campaign details.

**What kind of mask works best?**

Bria recommends blob-shaped masks for GenFill. Start with a compact region around the intended object rather than asking one selection to cover several unrelated changes.

**How should I write a Bria GenFill prompt?**

Describe the object you want inside the selected area, including its material and size. Explain how it should sit on the surface and ask for a contact shadow that matches the scene.

**Does Bria GenFill increase image resolution?**

Bria documents GenFill as returning the edited image at its original resolution. Treat it as an editing tool rather than an upscaling step.

**How can I repeat a result?**

Keep the source image, mask, prompt, and seed unchanged, and use the same model version. The documented repeatability guarantee depends on keeping the seed, prompt, and model version the same.

