How to Use fal Grain in Gemini CLI
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 Gemini CLI
Copy an example into Gemini CLI, 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 Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI 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: Gemini CLI 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 Gemini CLI 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 Gemini CLI?
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 Gemini CLI
Overview
fal Grain in other agents
More Gemini CLI guides
Questions about fal Grain in Gemini CLI
Can Gemini CLI use fal Grain?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run fal Grain like any built-in tool.
How much does fal Grain cost in Gemini CLI?
$0.0013 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.
Do I need a fal account to use fal Grain in Gemini CLI?
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 Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while fal Grain runs?
fal Grain runs in the background. Gemini CLI 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 Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


