[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [Fibo Edit](https://spiral.ai/integrations/n8n/fibo-edit)

# How to Use Fibo Edit in n8n

Fibo Edit changes existing images with structured control over color, lighting, style, and selected regions. Use it for product photo edits or repeatable visual changes, with a mask when the edit needs a defined boundary.

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

## Prompts to try with Fibo Edit in n8n

- Every Monday, use Fibo Edit on the approved chair photo to prepare a forest green upholstery preview. Retain the frame, texture, lighting, and background, and present it for review.
- Each Friday, use Fibo Edit on the approved campaign photo to prepare one lighting study with the main light from the left. Retain the composition and object colors.
- At the start of each month, use Fibo Edit on the approved editorial photo to prepare a vintage treatment with faded colors. Keep the framing and subject placement.
- Every Tuesday, use Fibo Edit on the approved room photo and cushion selection mask to prepare a rust red cushion preview. Preserve the surrounding image.
- Each Wednesday, use Fibo Edit on the approved bottle photo to prepare separate navy and dark green color previews. Start both from the original and retain their exact edit descriptions and random seeds.

## How to set up Fibo Edit 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 Fibo Edit in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Fibo Edit, 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 Fibo Edit**: 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": "bria/fibo-edit/edit",
    "input": {
      "image_url": "https://v3b.fal.media/files/b/0a8b07e8/GYKVk2EVivg_MC3jRRZi3_png%20-%202026-01-13T094835.850%20(3).png"
    }
  }'
```

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

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

## Fibo Edit tools and prices

- [Fibo Edit](https://spiral.ai/tools/fal/bria/fibo-edit/edit) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_url |  | — | Reference image (file or URL). |
| mask_url |  | — | Mask image (file or URL). Optional |
| instruction |  | — | Instruction for image editing. |
| vgl |  | — | A pre-built VGL document, edited from verbatim instead of building one from `instruction`. Send this or `instruction`, not both. |
| original_vgl |  | — | The VGL of the image as it is now. With `new_vgl`, edits by the difference between the two. |
| new_vgl |  | — | The VGL of the image as it should end up. Requires `original_vgl`. |

## What can you do with Fibo Edit in n8n?

Prepare recurring image edit drafts from an approved source photo and a clear visual brief. A scheduled agent can repeat a defined color or lighting task and retain the descriptions needed to review the results.

### Product color previews

Start with a product photo and request a specific color change. Compare the edited object with the original for unwanted changes to its shape and surface.

### Campaign lighting studies

Explore different lighting directions on an existing campaign image while requesting the same background and object textures.

### Vintage editorial images

Give an existing editorial photo a vintage treatment, with explicit instructions about the colors and composition to retain.

### Interior finish previews

Mask a cushion, chair, or other selected region in a room photo and request a new color without restyling the entire room.

### Background concepts

Revise the background description of an existing image to explore a different setting. Use a mask when the replacement needs a defined boundary.

### Controlled creative comparisons

Make separate edits from the same source image, changing one visual attribute per result. Keep the structured descriptions and seeds with each result for later comparison.

## Overview

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

## Fibo Edit in other agents

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

## More n8n guides

- [Fibo BBQ Preview](https://spiral.ai/integrations/n8n/fibo-bbq-preview)
- [Fibo Edit Add Object by Text](https://spiral.ai/integrations/n8n/fibo-edit-add-object-by-text)
- [Fibo 2.0 Generate](https://spiral.ai/integrations/n8n/fibo-2-0-generate)
- [Fibo Edit Blend](https://spiral.ai/integrations/n8n/fibo-edit-blend)
- [Fibo 2.0 Edit](https://spiral.ai/integrations/n8n/fibo-2-0-edit)
- [Fibo Edit Colorize](https://spiral.ai/integrations/n8n/fibo-edit-colorize)

## Questions about Fibo Edit in n8n

**Can n8n use Fibo Edit?**

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

**How much does Fibo Edit cost in n8n?**

$0.052 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 Fibo Edit in n8n?**

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

**How long does it take to set up Fibo Edit in n8n?**

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

**Does n8n wait while Fibo Edit runs?**

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

**What is Fibo Edit useful for?**

Use Fibo Edit to revise an existing image: recolor a product, change lighting, restyle a photo, or edit a selected region. Its structured scene descriptions also suit repeated edits with a consistent brief.

**How should I write a Fibo Edit prompt?**

Name the object, the attribute to change, and the desired result. For example: 'Change the car's paint to forest green; retain its texture, the background, and the lighting.'

**When should I use a mask?**

Use a mask when an edit needs a defined boundary, such as changing one cushion in a room photo. Fibo Edit supports targeting selected regions while preserving the surrounding image.

**What does VGL add to image editing?**

VGL describes a scene as structured JSON. It separates visual attributes so an edit can target lighting, color, or background explicitly, and Fibo Edit can work from the difference between original and revised descriptions.

**Can I repeat a Fibo Edit result?**

Keep the source image, any mask, the exact VGL description, and the seed used for the edit. Bria documents the same VGL and seed as the basis for reproducible rendering.

