[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Bria GenFill](https://spiral.ai/integrations/claude-code/bria-genfill)

# How to Use Bria GenFill in Claude Code

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 Claude Code

- Use Bria GenFill on the homepage photo in this project. Mask the vase and replace it with a short matte ceramic vase, matching the table contact and window lighting. Save a separate edited image and show it in the page preview.
- Use Bria GenFill to edit the product photo in the project assets. Replace the selected wooden tray with a shallow white ceramic dish, matching its scale and contact shadow. Show the original and edited photos side by side.
- Use Bria GenFill on the campaign image in this repository. Add a small wrapped gift inside a blob-shaped selection beside the product, with paper texture and a shadow that matches the scene.
- Use Bria GenFill to compare two descriptions for the selected lamp in the project photo: brushed steel and matte ceramic. Keep the source image, mask, and seed fixed, then put both results in a review page.
- Use Bria GenFill on the dessert photo in the project. Add one red cherry to the selected area on top of the cupcake, with realistic size and a small contact shadow. Update the preview to use the edited photo.

## How to set up Bria GenFill in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 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: Claude Code finds Bria GenFill on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## 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 Claude Code?

Revise existing project images with targeted object additions or replacements. A coding agent can pair those edits with a page preview so you can judge the result in context.

### 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 Claude Code guides](https://spiral.ai/integrations/claude-code)

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

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

## Questions about Bria GenFill in Claude Code

**Can Claude Code use Bria GenFill?**

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

**How much does Bria GenFill cost in Claude Code?**

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

**Do I need a fal account to use Bria GenFill in Claude Code?**

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 Claude Code?**

About two minutes: add the hosted server, then sign in.

**Does Claude Code wait while Bria GenFill runs?**

Bria GenFill runs in the background. Claude Code 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.

