How to Use fal Retouch in Windsurf
fal Retouch removes facial blemishes and improves skin in an existing photo. Use it for portrait cleanup, with LoRA strength controlling the retouch effect.
Prompts to try with fal Retouch in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use fal Retouch on the staff headshots in this project's assets directory. Save the results separately and build a preview pairing each original with its retouched image.
Use fal Retouch on the author portrait used by the biography page. Create a local comparison preview so I can inspect skin texture before replacing the current asset.
Use fal Retouch on one speaker headshot from this project at two different LoRA strengths. Keep the other settings identical and show both results beside the original.
Use fal Retouch on the profile portrait in this project's image assets. Check the returned dimensions against the profile component's display size and report whether resizing is needed.
Use fal Retouch on the selected portrait assets for the team page. Generate a review gallery with filenames and original images so I can choose which edits to keep.
How to set up fal Retouch in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- 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:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - 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.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run fal Retouch
One request; the result comes back by polling or a webhook.
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: Windsurf finds fal Retouch on Spiral, shows the price and runs it.
fal Retouch providers and prices
Spiral runs fal Retouch through fal. Open a card for today's price, with every fee included.
Settings you can ask for
fal Retouch works from your image URL. Ask Windsurf for any of these in your prompt.
| 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. |
| Number of 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 | a whole number | The same seed and the same prompt given to the same version of the model will output the same image every time. |
Every API field of Image Editing Retouch is on its tool page: open its card above.
What can you do with fal Retouch in Windsurf?
Prepare retouched portraits for a project's staff directory, author page, or speaker section. Have the agent keep originals, produce comparison previews, and check the returned dimensions against the layout.
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.
More on fal Retouch and Windsurf
Overview
fal Retouch in other agents
Questions about fal Retouch in Windsurf
Can Windsurf use fal Retouch?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run fal Retouch like any built-in tool.
How much does fal Retouch cost in Windsurf?
$0.052 per image. 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 fal Retouch in Windsurf?
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 Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while fal Retouch runs?
fal Retouch runs in the background. Windsurf 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.
Start using fal Retouch in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


