[Integrations](https://spiral.ai/integrations) › [Claude](https://spiral.ai/integrations/claude-desktop) › [fal Retouch](https://spiral.ai/integrations/claude-desktop/fal-retouch)

# How to Use fal Retouch in Claude

fal Retouch removes facial blemishes and improves skin in an existing photo. Use it for portrait cleanup, with LoRA strength controlling the retouch effect.

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

## Prompts to try with fal Retouch in Claude

- Use fal Retouch on this portrait for my professional profile. Show the result beside the original so I can inspect the skin treatment.
- Use fal Retouch on this speaker headshot. Compare the result with the original and flag any visible changes to facial details.
- Use fal Retouch on this author portrait at two different retouch strengths. Keep the other settings the same and show both results for comparison.
- Use fal Retouch on this portrait for my media kit. Show the result at full size so I can check freckles and skin texture.
- Use fal Retouch on this biography photo. Report the result's pixel dimensions so I can decide where to place it.

## How to set up fal Retouch in Claude

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

### Use the Claude connector

1. **Add Spiral to Claude**: Click Add Spiral in Claude above. Claude opens Add custom connector with Spiral and its URL filled in; check them and click Continue. Without the link: in Claude open Customize › Connectors › Add › Add custom connector and paste this URL:

```text
https://api.spiral.ai/mcp
```

2. **Keep the detected sign-in and click Add**: Claude finds Spiral's sign-in by itself: leave Sign in now and Use Claude's published identity selected.

3. **Click Connect**: The connector page opens. Connect takes you to Spiral in your browser.

### Use the Spiral skill

1. **Send Claude 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 fal Retouch**: 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/image-editing/retouch",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/gallery/tulsi.png"
    }
  }'
```

Then paste one of the prompts above: Claude finds fal Retouch on Spiral, shows the price and runs it.

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

## fal Retouch tools and prices

- [Image Editing Retouch](https://spiral.ai/tools/fal/fal-ai/image-editing/retouch) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| guidance_scale | 0 to 20 | 3.5 | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. |
| num_inference_steps | 1 to 50 | 30 | Number of inference steps for sampling. |
| lora_scale | 0 to 4 | 1 | The scale factor for the LoRA model. Controls the strength of the LoRA effect. |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |

## What can you do with fal Retouch in Claude?

Turn a supplied portrait into a retouched candidate for a profile, biography, or event page. Use the conversation to compare skin treatment and decide which result to keep.

### Staff directory portraits

Retouch facial blemishes in staff headshots, then compare each result with its original before updating the directory.

### Professional profile photos

Prepare a skin-retouched portrait for a professional profile. Review facial details at full size before choosing the final image.

### Speaker headshots

Clean up skin in a speaker's supplied portrait before placing it on a conference page or event announcement.

### Author portraits

Prepare a retouched author photo for a biography page, newsletter, or publication. Check the returned dimensions against the intended placement.

### Portrait proofing

Compare different retouch strengths on one portrait and present the results beside the original for selection.

### Creator media kits

Retouch an existing creator headshot for a media kit, then inspect skin texture and recognizable facial details before export.

## Overview

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

## fal Retouch in other agents

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

## More Claude guides

- [fal Object Removal](https://spiral.ai/integrations/claude-desktop/fal-object-removal)
- [fal Scene Composition](https://spiral.ai/integrations/claude-desktop/fal-scene-composition)
- [fal Hair Change](https://spiral.ai/integrations/claude-desktop/fal-hair-change)
- [fal Sharpen](https://spiral.ai/integrations/claude-desktop/fal-sharpen)
- [fal Grain](https://spiral.ai/integrations/claude-desktop/fal-grain)
- [fal Style Transfer](https://spiral.ai/integrations/claude-desktop/fal-style-transfer)

## Questions about fal Retouch in Claude

**Can Claude use fal Retouch?**

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

**How much does fal Retouch cost in Claude?**

$0.052 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude plan is separate.

**Do I need a fal account to use fal Retouch in Claude?**

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

**How long does it take to set up fal Retouch in Claude?**

About two minutes: add Spiral to Claude, then keep the detected sign-in and click Add, then click Connect.

**Does Claude wait while fal Retouch runs?**

fal Retouch runs in the background. Claude starts the run, checks on it and gives you the image when it's ready.

**What is fal Retouch best used for?**

Facial blemish removal and skin retouching in existing photographs. Consider it for headshots, profile pictures, and other portraits that need skin cleanup.

**How should I direct a fal Retouch task?**

Give your agent a concrete portrait task and a review criterion, such as checking skin texture against the original. Ask the agent to compare the result rather than assuming every requested detail will be preserved.

**Which setting matters when comparing retouch strength?**

LoRA strength controls the effect. Compare two strengths on the same portrait while holding other settings steady, then inspect the skin and facial details.

**What should I check before using a retouched portrait?**

Compare it with the original at full size. Check skin texture, freckles, facial features, and any details you want to retain before selecting the result.

**What resolution does fal Retouch produce?**

The published schema includes pixel dimensions but does not specify a fixed output resolution. Check the returned image's dimensions before using it in a layout or print job.

