[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [fal Blur](https://spiral.ai/integrations/n8n/fal-blur)

# How to Use fal Blur in n8n

fal Blur softens existing images with Gaussian filtering or simplifies their texture with Kuwahara filtering. Choose Gaussian for a smooth blur and Kuwahara when you want to retain outlines while reducing detail.

|  |  |
| --- | --- |
| Model | fal Blur |
| 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 Blur in n8n

- Every Monday, use fal Blur on the new image URLs supplied for the weekly presentation. Apply Gaussian blur with radius 5 and sigma 1, and return previews for review.
- Each morning, use fal Blur on the newly supplied landscape photos. Make Kuwahara treatments at radius 3 and flag visible blocky patches for review.
- Every Friday, use fal Blur on the supplied editorial portrait URLs. Compare Kuwahara radii 3 and 5 and report which results need closer inspection around the eyes and hair.
- When new background photo URLs arrive, use fal Blur to compare Gaussian treatments at radius 7 with sigma values 1 and 2. Keep both results for review.
- On the first day of each month, use fal Blur on the supplied campaign photo URLs. Compare Gaussian and Kuwahara blur at radius 5, using sigma 1 for Gaussian, and return a visual review.

## How to set up fal Blur in n8n

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

### Use the Spiral skill

1. **Send n8n 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 a key**: Create a key under API keys in the console.

2. **Add an MCP Client node**: In a workflow, add an MCP Client node (or, under an AI Agent node, an MCP Client Tool) and set:

```text
https://api.spiral.ai/mcp
```

3. **Pick a tool**: The node lists Spiral's tools. In an MCP Client node pick one, such as `run`, and give it its arguments:

```json
{
  "provider": "fal",
  "model": "fal-ai/flux/schnell",
  "input": { "prompt": "a lighthouse at dawn" },
  "wait": true
}
```

4. **Run fal Blur in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds fal Blur, prices it and runs it each time the step fires.

### 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 Blur**: 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/blur",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/web-examples/post-process/postpro-input.jpg"
    }
  }'
```

Then paste one of the prompts above: n8n finds fal Blur on Spiral, shows the price and runs it.

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

## fal Blur tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| blur_type | gaussian, kuwahara | gaussian | Type of blur to apply |
| blur_radius | 0 to 31 | 3 | Blur radius |
| blur_sigma | 0.1 to 10 | 1 | Sigma for Gaussian blur |

## What can you do with fal Blur in n8n?

Prepare consistent image treatments whenever new source images arrive. Schedule comparisons for review, with checks for softened lettering and distracting texture patches.

### Backgrounds for presentation slides

Try Gaussian filtering on a photograph before placing slide text over it. Compare a few strengths to find enough softness without losing the scene.

### Illustrated landscape treatments

Use Kuwahara filtering on a landscape photo to simplify foliage and other fine texture. Review the result for distracting patches.

### Light noise reduction

Try a mild Gaussian treatment on an image with Gaussian noise. Keep the original beside the result to judge whether the lost detail is acceptable.

### Website background assets

Create softened copies of existing photography for website backgrounds. Add navigation and other text after filtering so their edges stay sharp.

### Simplified editorial portraits

Compare Kuwahara treatments for a portrait with less skin and clothing texture. Inspect eyes, hair, and facial outlines before selecting one.

### Image treatment comparisons

Produce Gaussian and Kuwahara treatments from the same source photo for a design review. Compare smooth softness against texture simplification.

## Overview

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

## fal Blur in other agents

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

## More n8n guides

- [Z-Image Turbo LoRA](https://spiral.ai/integrations/n8n/z-image-turbo-lora)
- [fal Desaturate](https://spiral.ai/integrations/n8n/fal-desaturate)
- [Z-Image Turbo](https://spiral.ai/integrations/n8n/z-image-turbo)
- [fal Expression Change](https://spiral.ai/integrations/n8n/fal-expression-change)
- [Z-Image Base LoRA](https://spiral.ai/integrations/n8n/z-image-base-lora)
- [fal Grain](https://spiral.ai/integrations/n8n/fal-grain)

## Questions about fal Blur in n8n

**Can n8n use fal Blur?**

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

**How much does fal Blur cost in n8n?**

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

**Do I need a fal account to use fal Blur in n8n?**

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

**How long does it take to set up fal Blur in n8n?**

About two minutes: create a key, then add an MCP Client node, then pick a tool.

**Does n8n wait while fal Blur runs?**

fal Blur runs in the background. n8n starts the run, checks on it and gives you the image when it's ready.

**When should I choose Gaussian or Kuwahara blur?**

Choose Gaussian for a smooth blur that also softens edges. Try Kuwahara when you want simpler texture with more of the outlines retained.

**What does sigma change?**

Sigma controls the spread of Gaussian filtering. Compare a few values on the same original image, keeping the radius fixed so you can judge the difference.

**Will blur preserve small details?**

Gaussian blur softens edges, and larger Kuwahara filtering windows can remove small details. Check lettering, hair, and thin lines before choosing the final result.

**Why can Kuwahara blur look blocky?**

Conventional Kuwahara filtering can create rectangular areas of similar color. If those patches distract from the image, compare a smaller radius or switch to Gaussian.

**Can Gaussian blur reduce image noise?**

It can reduce Gaussian noise, but it also softens edges. Start with a light treatment and compare the noise reduction against the detail you lose.

