[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Object Removal Mask](https://spiral.ai/integrations/claude-code/object-removal-mask)

# How to Use Object Removal Mask in Claude Code

Object Removal Mask removes selected objects and reconstructs the scene behind them. Unlike Object Removal, which identifies targets from text, it lets you specify the removal area with a mask.

|  |  |
| --- | --- |
| Model | Object Removal Mask |
| Available through | fal |
| Category | Image |
| Price | $0.0078 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Object Removal Mask in Claude Code

- Use Object Removal Mask on the product photo in public/images and its matching mask to remove the stray prop. Save a separate edited copy and show a before-and-after comparison.
- Use Object Removal Mask on the hero photo and mask in assets/photos. Compare mask expansion of 0 and 5 pixels, then show the target's edges at full size.
- Use Object Removal Mask to remove the cable marked in the room photo's mask in this project. Save the result separately and highlight the reconstructed floor for review.
- Use Object Removal Mask on the portrait asset and supplied mask to remove the background distraction. Compare the subject's hair and clothing with the original before proposing an asset replacement.
- Use Object Removal Mask to clean the masked litter from the landscape asset. Create a local comparison view that lets me inspect the filled area and any remaining shadow.

## How to set up Object Removal Mask 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 Object Removal Mask**: 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/object-removal/mask",
    "input": {
      "image_url": "https://v3.fal.media/files/zebra/o0DORfJawy-T9P_-NsvLY.png",
      "mask_url": "https://v3.fal.media/files/tiger/7nq9-v-lJtBCPnK1332fr.png"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Object Removal Mask on Spiral, shows the price and runs it.

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

## Object Removal Mask tools and prices

- [Object Removal · Mask](https://spiral.ai/tools/fal/fal-ai/object-removal/mask) (fal): $0.0078 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| model | low_quality, medium_quality, high_quality, best_quality | best_quality |  |
| mask_expansion | 0 to 50 | 15 | Amount of pixels to expand the mask by. Range: 0-50 |

## What can you do with Object Removal Mask in Claude Code?

Object Removal Mask lets you clean photo assets used in a project by selecting the object to remove. Keep the original alongside the edit so you can review reconstructed details before replacing an asset.

### Product photo cleanup

Use Object Removal Mask to remove a stray prop from a product photo. Mask the prop and inspect the product outline and nearby surface after editing.

### Portrait background cleanup

Use Object Removal Mask to remove a distracting object behind a portrait subject. Review the edit near hair, clothing, and other details you want to keep.

### Travel photo cleanup

Use Object Removal Mask to remove a selected distraction from a travel photo. Check reconstructed pavement, railings, and building edges before sharing.

### Interior photography

Use Object Removal Mask to remove a loose cable or discarded packaging from a room photo. Inspect the reconstructed wall or floor against the original.

### Food photo retouching

Use Object Removal Mask to remove an unwanted utensil or napkin from a tabletop composition. Keep the selection clear of the dish and review the filled surface.

### Outdoor scene cleanup

Use Object Removal Mask to remove a piece of litter from a landscape photo. Check the replacement texture and any remaining trace of the object's shadow.

## Overview

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

## Object Removal Mask in other agents

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

## More Claude Code guides

- [Object Removal Bounding Box](https://spiral.ai/integrations/claude-code/object-removal-bounding-box)
- [Object Removal Prompt](https://spiral.ai/integrations/claude-code/object-removal-prompt)
- [Object Removal](https://spiral.ai/integrations/claude-code/object-removal)
- [PATINA Extract Material](https://spiral.ai/integrations/claude-code/patina-extract-material)
- [Nano Banana Pro Text to Image](https://spiral.ai/integrations/claude-code/nano-banana-pro-text-to-image)
- [PATINA Image to Maps](https://spiral.ai/integrations/claude-code/patina-image-to-maps)

## Questions about Object Removal Mask in Claude Code

**Can Claude Code use Object Removal Mask?**

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

**How much does Object Removal Mask cost in Claude Code?**

$0.0078 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 Object Removal Mask in Claude Code?**

No. Spiral runs Object Removal Mask on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Object Removal Mask in Claude Code?**

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

**Does Claude Code wait while Object Removal Mask runs?**

Object Removal Mask runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.

**What is Object Removal Mask useful for?**

Use it to remove a selected object from an existing photo and fill the space with scene-appropriate content. Practical tasks include removing a stray prop, background distraction, or piece of litter.

**How do I specify exactly what should disappear?**

Mark the removal area with white pixels in the mask. For a precise edit, inspect the selection around the target before running the removal.

**Can Object Removal Mask remove an object's visual effects too?**

The documented capability includes removing an object's visual effects. After editing, check for leftover shadows or reflections as well as the object itself.

**How should I adjust mask expansion?**

Try a small expansion when the target sits close to something you want to keep. If the result leaves an outline, compare it with a slightly wider selection and inspect both results.

**Does Object Removal Mask recover the original hidden background?**

The documentation describes reconstruction with contextually appropriate content. Treat that as a plausible fill rather than proof of what was behind the object, and inspect important details before using the image.

