How to Use fal Desaturate in Codex
Use fal Desaturate to reduce color in an existing image for muted photos and grayscale proofs. Compare conversion methods on the same image before choosing the final look.
Prompts to try with fal Desaturate in Codex
Copy an example into Codex, or ask in your own words.
Use fal Desaturate on the homepage hero photo in this project. Create previews at strengths 0.25, 0.5, and 0.75 using Rec.709, and save them with descriptive filenames.
Use fal Desaturate on the project's author portrait. Compare Rec.709 and lightness at strength 0.75, then show both beside the original.
Use fal Desaturate on the article photos referenced by the blog index. Apply strength 0.4 with Rec.709 and prepare a contact sheet for review.
Use fal Desaturate to prepare grayscale proofs of the illustrations in the documentation assets. Compare average and Rec.709 at strength 1.
Use fal Desaturate on the landing page background photo at strength 0.5 with Rec.709. Add the result to a local page preview so I can assess the treatment.
How to set up fal Desaturate 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 Desaturate
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/desaturate", "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 Desaturate on Spiral, shows the price and runs it.
fal Desaturate providers and prices
Spiral runs fal Desaturate through fal. Open a card for today's price, with every fee included.
Settings you can ask for
fal Desaturate works from your image URL. Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Desaturate factor | 0 to 1 | 1 | Desaturation factor |
| Desaturate method | luminance (Rec.709), luminance (Rec.601), average, or lightness | luminance (Rec.709) | Desaturation method |
Every API field of Post Processing Desaturate is on its tool page: open its card above.
What can you do with fal Desaturate in Codex?
Create reduced-color treatments for the images in your project. Have the agent prepare comparisons before you choose which assets belong in the interface.
Muted editorial photos
Reduce color in an existing article photo. Compare a few strengths before choosing the image for publication.
Portrait treatment previews
Compare desaturation methods on a portrait before choosing a restrained color treatment.
Grayscale print proofs
Prepare a grayscale preview of a photograph for a newsletter or handout. Review the result before placing it in the document.
Website photo treatments
Try reduced color on existing hero and section photos, then review each result in the page layout.
Social image comparisons
Prepare several color reduction treatments of an existing campaign image for an editorial review.
Illustration value studies
Make a grayscale study of an existing illustration and inspect how its colored areas translate into gray.
More on fal Desaturate and Codex
Overview
fal Desaturate in other agents
Questions about fal Desaturate in Codex
Can Codex use fal Desaturate?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run fal Desaturate like any built-in tool.
How much does fal Desaturate 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 Desaturate in Codex?
No. Spiral runs fal Desaturate 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 Desaturate in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while fal Desaturate runs?
fal Desaturate runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.
What is Desaturate useful for?
Use it to reduce color in existing photographs, prepare muted editorial images, or make grayscale proofs. Start with the image you want to edit.
How should I prompt an agent to use Desaturate?
Identify the image and ask for a specific color reduction. For example, request three previews at different strengths and ask the agent to label them for comparison.
Which conversion method should I choose?
Compare methods on the same image while holding the strength constant. Check colorful areas first, since the original hues affect the differences between grayscale conversions.
How do I choose a desaturation strength?
Try amounts of 0.25, 0.5, and 0.75 as a first comparison. Pick a preview, then make a smaller adjustment around that value.
Can Desaturate keep one object colorful while removing color elsewhere?
The documented operation has no mask or object selection control. Plan that effect as a separate masking and compositing task.
Start using fal Desaturate 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


