How to Use fal Grain in Windsurf
fal Grain adds film grain to an existing image for photographic finishing. Use it to compare texture treatments while adjusting intensity and scale.
Prompts to try with fal Grain in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use fal Grain on the homepage photo in this project with modern style and intensity 0.2; show it beside the original.
Use fal Grain on our editorial cover image with analog style at three intensities, keeping scale fixed for comparison.
Use fal Grain to compare kodak and fuji styles on the portfolio portrait, holding intensity and scale constant.
Use fal Grain on the music page artwork with cinematic style; keep the page title as separate HTML text.
Use fal Grain on the project’s poster image with newspaper style, then preview it in the existing poster layout.
How to set up fal Grain 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 Grain
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/post-processing/grain", "input": { "image_url": "https://storage.googleapis.com/falserverless/web-examples/post-process/postpro-input.jpg" } }'
Then paste one of the prompts above: Windsurf finds fal Grain on Spiral, shows the price and runs it.
fal Grain providers and prices
Spiral runs fal Grain through fal. Open a card for today's price, with every fee included.
Settings you can ask for
fal Grain works from your image URL. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Grain intensity | 0 to 1 | 0.4 | Film grain intensity |
| Grain scale | 1 to 100 | 10 | Film grain scale |
| Grain style | modern, analog, kodak, fuji, cinematic, or newspaper | modern | Style of film grain to apply |
Every API field of Post Processing Grain is on its tool page: open its card above.
What can you do with fal Grain in Windsurf?
Create grain-treated photography for a website or app using fal Grain. Have the coding agent compare treatments in the project's layout before choosing an asset.
Portrait finishing
Try a restrained grain treatment on a finished portrait, then compare the face and background with the original.
Travel photo essays
Apply a chosen grain treatment across selected travel photos, reviewing each image before assembling the essay.
Music cover artwork
Test pronounced grain on existing cover artwork. Add the title separately after selecting the image treatment.
Fashion editorial selects
Compare grain styles on a representative fashion photograph before treating the remaining selects.
Website photography
Prepare grain-treated alternatives for existing website photos and compare them in the actual page layout.
Film poster concepts
Apply grain to an existing poster image, then review it with the typography placed above the treated artwork.
More on fal Grain and Windsurf
Overview
fal Grain in other agents
Questions about fal Grain in Windsurf
Can Windsurf use fal Grain?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run fal Grain like any built-in tool.
How much does fal Grain cost in Windsurf?
$0.0013 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 Grain in Windsurf?
No. Spiral runs fal Grain 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 Grain in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while fal Grain runs?
fal Grain runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.
What is fal Grain useful for?
It adds film grain to existing images. Try it when a portrait, editorial photo, or cover image needs a deliberate texture treatment.
How should I describe the result I want?
Give the agent a concrete editing brief: identify the image, request a light or pronounced treatment, and ask for comparisons. For example, request three intensity levels with style and scale held constant.
How should I tune the grain?
Compare styles first while keeping intensity and scale fixed. Then adjust one setting at a time so you can judge what changed.
How can I check whether the grain looks right?
Review the result at several zoom levels, including its intended display size. Keep the original beside it and inspect faces, smooth backgrounds, and fine details.
When should I keep a clean version?
Keep a clean comparison when small lettering, product labels, or fine detail matters. Choose the grain treatment only after checking those areas at the intended viewing size.
Start using fal Grain 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


