[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [fal Desaturate](https://spiral.ai/integrations/dots/fal-desaturate)

# How to Use fal Desaturate in dots

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.

|  |  |
| --- | --- |
| Model | fal Desaturate |
| Available through | fal |
| Category | Image |
| Price | $0.0013 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with fal Desaturate in dots

- Every Monday, use fal Desaturate on newly approved editorial photos. Create previews using the Rec.709 method at a color reduction amount of 0.4, and collect them for review.
- Each morning, use fal Desaturate on new newsletter photos. Prepare grayscale proofs using the Rec.709 method at a color reduction amount of 1, with originals alongside.
- Every Friday, use fal Desaturate on newly approved campaign images. Prepare comparisons at color reduction amounts of 0.25 and 0.5 using the Rec.709 method.
- Once a week, use fal Desaturate on new staff portraits. Compare the Rec.709 and lightness methods at a color reduction amount of 0.75, and label each preview.
- At the end of each month, use fal Desaturate on newly approved illustrations. Make grayscale studies with the average method at a color reduction amount of 1 for the design review.

## How to set up fal Desaturate in dots

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send dots this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run fal Desaturate**: One request; the result comes back by polling or a webhook.

```bash
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: dots finds fal Desaturate on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/dots

## fal Desaturate tools and prices

- [Post Processing Desaturate](https://spiral.ai/tools/fal/fal-ai/post-processing/desaturate) (fal): $0.0013 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| desaturate_factor | 0 to 1 | 1 | Desaturation factor |
| desaturate_method | luminance (Rec.709), luminance (Rec.601), average, lightness | luminance (Rec.709) | Desaturation method |

## What can you do with fal Desaturate in dots?

Prepare consistent color treatment previews as new images arrive. Use a scheduled review to compare the processed images with their originals before publication.

### 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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All dots guides](https://spiral.ai/integrations/dots)

## fal Desaturate in other agents

- [Amp](https://spiral.ai/integrations/amp/fal-desaturate)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/fal-desaturate)
- [Claude](https://spiral.ai/integrations/claude-desktop/fal-desaturate)
- [Claude Code](https://spiral.ai/integrations/claude-code/fal-desaturate)
- [Cline](https://spiral.ai/integrations/cline/fal-desaturate)
- [Codex](https://spiral.ai/integrations/codex/fal-desaturate)
- [Cursor](https://spiral.ai/integrations/cursor/fal-desaturate)
- [Devin](https://spiral.ai/integrations/devin/fal-desaturate)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/fal-desaturate)
- [Gemini](https://spiral.ai/integrations/gemini/fal-desaturate)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/fal-desaturate)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/fal-desaturate)
- [goose](https://spiral.ai/integrations/goose/fal-desaturate)
- [Grok](https://spiral.ai/integrations/grok/fal-desaturate)
- [Grok Build](https://spiral.ai/integrations/grok-build/fal-desaturate)
- [Hermes](https://spiral.ai/integrations/hermes/fal-desaturate)
- [Instinct](https://spiral.ai/integrations/instinct/fal-desaturate)
- [Manus](https://spiral.ai/integrations/manus/fal-desaturate)
- [Muse](https://spiral.ai/integrations/muse/fal-desaturate)
- [Muse Code](https://spiral.ai/integrations/muse-code/fal-desaturate)
- [n8n](https://spiral.ai/integrations/n8n/fal-desaturate)
- [Notion](https://spiral.ai/integrations/notion/fal-desaturate)
- [OpenClaw](https://spiral.ai/integrations/openclaw/fal-desaturate)
- [opencode](https://spiral.ai/integrations/opencode/fal-desaturate)
- [Perplexity](https://spiral.ai/integrations/perplexity/fal-desaturate)
- [Raycast](https://spiral.ai/integrations/raycast/fal-desaturate)
- [VS Code](https://spiral.ai/integrations/vscode/fal-desaturate)
- [Windsurf](https://spiral.ai/integrations/windsurf/fal-desaturate)
- [Zapier](https://spiral.ai/integrations/zapier/fal-desaturate)

## More dots guides

- [fal Blur](https://spiral.ai/integrations/dots/fal-blur)
- [fal Expression Change](https://spiral.ai/integrations/dots/fal-expression-change)
- [Z-Image Turbo LoRA](https://spiral.ai/integrations/dots/z-image-turbo-lora)
- [fal Grain](https://spiral.ai/integrations/dots/fal-grain)
- [Z-Image Turbo](https://spiral.ai/integrations/dots/z-image-turbo)
- [fal Hair Change](https://spiral.ai/integrations/dots/fal-hair-change)

## Questions about fal Desaturate in dots

**Can dots use fal Desaturate?**

Yes. Add Spiral to dots as an MCP server, and dots can find and run fal Desaturate like any built-in tool.

**How much does fal Desaturate cost in dots?**

$0.0013 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.

**Do I need a fal account to use fal Desaturate in dots?**

You need no fal account. dots uses one Spiral API key for every tool, and Spiral runs fal Desaturate on its own fal account.

**How long does it take to set up fal Desaturate in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while fal Desaturate runs?**

fal Desaturate runs in the background. dots 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.

