[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Bria Guided Remove Background](https://spiral.ai/integrations/claude-code/bria-guided-remove-background)

# How to Use Bria Guided Remove Background in Claude Code

Bria Guided Remove Background makes transparent cutouts while preserving the photo's original pixels. Unlike Bria Remove Background, it lets you name extra objects to keep, unwanted objects to drop, or one subject to isolate.

|  |  |
| --- | --- |
| Model | Bria Guided Remove Background |
| Available through | fal |
| Category | Image |
| Price | $0.039 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Bria Guided Remove Background in Claude Code

- Use Bria Guided Remove Background on public/images/backpack.jpg with the instruction 'only the backpack.' Save the transparent PNG beside the source and use it in the product card.
- Use Bria Guided Remove Background on public/images/cyclist.jpg to keep only the cyclist and bicycle. Save the cutout and add it to the activity page.
- Use Bria Guided Remove Background on assets/team-portrait.jpg to keep only the person. Add the transparent result to the team page and preview its edges against the page background.
- Use Bria Guided Remove Background on assets/desk-photo.jpg with the instruction 'only the desk lamp.' Save the result for the lighting collection page.
- Use Bria Guided Remove Background on assets/camera-kit.jpg to keep only the camera, lens, and strap. Save the transparent cutout and use it in the bundle component.

## How to set up Bria Guided Remove Background 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 Guided Remove Background**: 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/guided-remove-background",
    "input": {
      "image_url": "https://labs-assets.bria.ai/api-examples/guided-remove-background/yoga_studio_input.jpg"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Bria Guided Remove Background on Spiral, shows the price and runs it.

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

## Bria Guided Remove Background tools and prices

- [Bria Guided Remove Background](https://spiral.ai/tools/fal/bria/guided-remove-background) (fal): $0.039 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_url |  | https://labs-assets.bria.ai/api-examples/guided-remove-background/yoga_studio_input.jpg | Source image as a public URL, a base64 data URI (data:image/png;base64,...) or raw base64-encoded image bytes. |
| prompt |  | — | Optional. Plain words for how to change the default cutout of the photo's obvious subject: add something ('the person with the mat and the plant'), drop something ('the woman at her desk without the lamp') or narrow it ('only the chair'). Everything kept is the original pixels with a new alpha channel. Leave it empty for the plain cutout of the obvious subject. |
| autocrop |  | false | Tighten the output canvas to the kept content. |

## What can you do with Bria Guided Remove Background in Claude Code?

Turn project photos into transparent assets for product cards, team pages, and other layouts with Bria Guided Remove Background. Your coding agent can save the cutouts alongside the project's assets and place them in the interface.

### Product listing cutouts

Extract a photographed product for a listing layout. Name only the product when display props should be excluded.

### Product bundle images

Keep a product and its photographed accessories together for a bundle graphic. Specify each item that belongs in the cutout.

### Speaker portraits

Isolate a speaker from an event photo for a conference program, presentation, or announcement.

### Furniture mood boards

Extract a chair, lamp, or table from a room photo for a design board. Use 'only' to identify the piece you need.

### Activity graphics

Keep a person and relevant equipment together, such as a cyclist with a bicycle, for an instructional graphic.

### Campaign asset reuse

Make separate cutouts from one photograph: a person alone, a product alone, or both together for different layouts.

### Resale item images

Isolate a photographed resale item from surrounding clutter. Review areas where other objects overlap the item before using the result.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Bria Guided Remove Background in other agents

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

## More Claude Code guides

- [Bria GenFill v2](https://spiral.ai/integrations/claude-code/bria-genfill-v2)
- [Bria HD](https://spiral.ai/integrations/claude-code/bria-hd)
- [Bria GenFill](https://spiral.ai/integrations/claude-code/bria-genfill)
- [Bria Increase Resolution](https://spiral.ai/integrations/claude-code/bria-increase-resolution)
- [Bria Fibo](https://spiral.ai/integrations/claude-code/bria-fibo)
- [Bria Product Dimensions](https://spiral.ai/integrations/claude-code/bria-product-dimensions)

## Questions about Bria Guided Remove Background in Claude Code

**Can Claude Code use Bria Guided Remove Background?**

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

**How much does Bria Guided Remove Background cost in Claude Code?**

$0.039 per image. 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 Guided Remove Background in Claude Code?**

No. Spiral runs Bria Guided Remove Background 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 Guided Remove Background in Claude Code?**

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

**Does Claude Code wait while Bria Guided Remove Background runs?**

Bria Guided Remove Background runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.

**What is Bria Guided Remove Background good for?**

Use it to extract people, products, or selected objects as transparent cutouts. It is especially useful when the automatic cutout keeps an unwanted object or leaves out something you need.

**Does Bria Guided Remove Background change the subject's appearance?**

It retains the original photo pixels and changes their transparency. It does not repaint the subject, so use it for extraction rather than changes to color, lighting, or texture.

**What resolution and format does it return?**

The result is a transparent RGBA PNG. Bria documents output at the source image's original resolution, so background removal does not add image detail.

**How should I describe what to keep?**

Name the visible objects you want retained or excluded. Use 'only' for a strict selection, such as 'only the person and the bicycle,' and 'without' to exclude an unwanted object.

**Can it rebuild a subject hidden behind a removed object?**

No. Areas hidden behind the removed object remain transparent, so removing an object held in someone's hand will not reconstruct the covered hand.

