[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Bria GenFill v2](https://spiral.ai/integrations/windsurf/bria-genfill-v2)

# How to Use Bria GenFill v2 in Windsurf

Bria GenFill v2 adds objects to selected areas of an existing image, such as a vase on a table or a prop beside a product. It favors blob-shaped masks and keeps the original resolution and pixels outside the mask.

|  |  |
| --- | --- |
| Model | Bria GenFill v2 |
| Available through | fal |
| Category | Image |
| Price | $0.052 per 1,048,576 megapixels. Minimum 1,048,576 pixels. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Bria GenFill v2 in Windsurf

- Use Bria GenFill v2 on assets/desk.jpg with assets/desk-mask.png. Add a small brushed-steel lamp resting on the desk with a soft contact shadow. Save a new image and show it in the existing page.
- Use Bria GenFill v2 with the product photo and matching mask in public/images. Add a shallow ceramic dish beside the bottle, scaled to its base. Keep the bottle outside the mask and save the result separately.
- Use Bria GenFill v2 on the dining-room photo and its mask in this project. Add a low glass vase on the selected tabletop area. Describe its size, surface contact, and shadow, then save a preview.
- Use Bria GenFill v2 with the campaign photo and prepared mask in assets. Add a small orange pumpkin beside the display. Save the edited asset and a record of the instruction and seed.
- Use Bria GenFill v2 on the article photo and matching mask in this repository. Add a closed linen notebook on the selected desk area. Keep the original asset and show both images for review.

## How to set up Bria GenFill v2 in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

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

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 v2**: 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": "bria/genfill/v2",
    "input": {
      "image_url": "https://bria-datasets.s3.us-east-1.amazonaws.com/Fibo_edit/flower.png",
      "mask_url": "https://bria-datasets.s3.us-east-1.amazonaws.com/Fibo_edit/flower_input_mask.png",
      "instruction": "A beautiful colorful butterfly"
    }
  }'
```

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

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

## Bria GenFill v2 tools and prices

- [Genfill v2 · Image to Image](https://spiral.ai/tools/fal/bria/genfill/v2) (fal): $0.052 per 1,048,576 megapixels. Minimum 1,048,576 pixels.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | 5555 | Random seed for reproducibility. |
| steps_num | 20 to 50 | 30 | Number of inference steps. |

## What can you do with Bria GenFill v2 in Windsurf?

Add targeted objects to image assets already used in your project. Your coding agent can pair each source with its mask and save the edited image for review in the page.

### Product photo props

Add a ceramic dish or wooden tray beside a product. Keep the product outside the mask and describe the prop's scale and contact shadow.

### Interior styling concepts

Explore a vase, table lamp, or decorative bowl in a room photo by selecting the area where the object should appear.

### Food photo additions

Add a lemon, a small bowl of berries, or another ingredient beside a plated dish while leaving the dish outside the mask.

### Seasonal ad concepts

Add a pumpkin, wrapped gift, or other seasonal prop to a selected area of an existing campaign photo.

### Editorial still-life edits

Place a notebook, pencil, or cup into a selected tabletop area for an article illustration.

### Website image refreshes

Add a relevant object to an existing website photo. Keep the subject outside the mask and retain the source image's pixel dimensions.

## Overview

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

## Bria GenFill v2 in other agents

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

## More Windsurf guides

- [Bria GenFill](https://spiral.ai/integrations/windsurf/bria-genfill)
- [Bria Guided Remove Background](https://spiral.ai/integrations/windsurf/bria-guided-remove-background)
- [Bria Fibo](https://spiral.ai/integrations/windsurf/bria-fibo)
- [Bria HD](https://spiral.ai/integrations/windsurf/bria-hd)
- [Bria Fast](https://spiral.ai/integrations/windsurf/bria-fast)
- [Bria Increase Resolution](https://spiral.ai/integrations/windsurf/bria-increase-resolution)

## Questions about Bria GenFill v2 in Windsurf

**Can Windsurf use Bria GenFill v2?**

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

**How much does Bria GenFill v2 cost in Windsurf?**

$0.052 per 1,048,576 megapixels. Minimum 1,048,576 pixels. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

**Do I need a fal account to use Bria GenFill v2 in Windsurf?**

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

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

**Does Windsurf wait while Bria GenFill v2 runs?**

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

**What is Bria GenFill v2 best suited for?**

Adding an object to a selected area of an existing image. Practical examples include a lamp on a desk, fruit beside a plate, or a decorative prop beside a product.

**What mask shape works best?**

Bria GenFill v2 is optimized for blob-shaped masks. Prefer a rounded selection around the intended object area when planning an edit.

**Does Bria GenFill v2 change the rest of the image?**

Bria documents that areas outside the mask remain unchanged. Keep anything you need to preserve outside the selected region.

**Does Bria GenFill v2 increase image resolution?**

Generative Fill returns the image at its original resolution. Treat it as a content edit; use a separate upscaling step when you need larger pixel dimensions.

**How should I describe the object I want?**

Name the object, its material, and its size relative to nearby objects. Describe how it sits on the surface and request a contact shadow.

