How to Use fal Grain in Codex
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 Codex
Copy an example into Codex, 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 Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex 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: Codex 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 Codex 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 Codex?
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 Codex
Overview
fal Grain in other agents
Questions about fal Grain in Codex
Can Codex use fal Grain?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run fal Grain like any built-in tool.
How much does fal Grain cost in Codex?
$0.0013 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need a fal account to use fal Grain in Codex?
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 Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while fal Grain runs?
fal Grain runs in the background. Codex 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 Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


