[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [fal Desaturate](https://spiral.ai/integrations/muse-code/fal-desaturate)

# How to Use fal Desaturate in Muse Code

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, no API key |

## Prompts to try with fal Desaturate in Muse Code

- 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 Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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 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: Muse Code finds fal Desaturate on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## 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 Muse Code?

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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## 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)
- [dots](https://spiral.ai/integrations/dots/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)
- [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 Muse Code guides

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

## Questions about fal Desaturate in Muse Code

**Can Muse Code use fal Desaturate?**

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

**How much does fal Desaturate cost in Muse Code?**

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

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

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 Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while fal Desaturate runs?**

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

