[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [fal Vignette](https://spiral.ai/integrations/gemini-cli/fal-vignette)

# How to Use fal Vignette in Gemini CLI

fal Vignette adds adjustable darkening around an existing image's edges. Use it to finish portraits, product shots, or editorial photos where you want less emphasis on the edges.

|  |  |
| --- | --- |
| Model | fal Vignette |
| 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 Vignette in Gemini CLI

- Use fal Vignette on the hero photo in this project. Make a light edge-darkening treatment, save it separately, and show it beside the original.
- Use fal Vignette to make light and stronger treatments of the project's article cover image. Preview both in the article layout so I can choose.
- Use fal Vignette on the centered product photo in our campaign assets. Start with light darkening and flag any packaging text near the edges for review.
- Use fal Vignette to prepare a dark-edged treatment of the album artwork in this repository. Save a separate copy for review before we add typography.
- Use fal Vignette on one representative portrait from the project's image assets. Show the original and edited versions at the size used by the page.

## How to set up fal Vignette in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 Vignette**: 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/vignette",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/web-examples/post-process/postpro-input.jpg"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds fal Vignette on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## fal Vignette tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| vignette_strength | 0 to 10 | 0.5 | Vignette strength |

## What can you do with fal Vignette in Gemini CLI?

Create vignette treatments for project images and review them in the layouts where they will appear. Ask the agent to compare edge darkening on the same original before replacing an asset.

### Portrait finishing

Try light edge darkening on a portrait with a centered face. Compare the original and edited photo before choosing the treatment.

### Product campaign images

Apply a vignette to a styled product photo where darker edges suit the campaign. Check packaging text and product details near the border.

### Food photography

Test a light vignette on a centered dish. Review the plate rim and table details before keeping the edit.

### Editorial cover photos

Compare light and stronger edge darkening on an existing article cover photo. Review the image in its final layout before selecting it.

### Album artwork treatments

Try darker edges on existing album artwork. Compare treatments before adding final typography.

### Event photo selections

Test a consistent vignette treatment on selected event photos. Review each composition separately so people near the edges remain visible.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## fal Vignette in other agents

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

## More Gemini CLI guides

- [fal Text Removal](https://spiral.ai/integrations/gemini-cli/fal-text-removal)
- [AFCD food groups](https://spiral.ai/integrations/gemini-cli/afcd-food-groups)
- [fal Style Transfer](https://spiral.ai/integrations/gemini-cli/fal-style-transfer)
- [AFCD food nutrient profile](https://spiral.ai/integrations/gemini-cli/afcd-food-nutrient-profile)
- [fal Sharpen](https://spiral.ai/integrations/gemini-cli/fal-sharpen)
- [AFCD food search](https://spiral.ai/integrations/gemini-cli/afcd-food-search)

## Questions about fal Vignette in Gemini CLI

**Can Gemini CLI use fal Vignette?**

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

**How much does fal Vignette cost in Gemini CLI?**

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

**Do I need a fal account to use fal Vignette in Gemini CLI?**

No. Spiral runs fal Vignette 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 Vignette in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while fal Vignette runs?**

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

**What does fal Vignette do?**

It darkens the edges of an existing image with adjustable strength. Use it as a finishing effect when you want the outer areas to draw less attention.

**Which photos should I try with fal Vignette?**

Try a portrait, food photo, or product shot with the main subject near the center. This is an editing recommendation based on where the darkening appears; compare the result with your original.

**How can I avoid making the vignette too obvious?**

Start with a light effect and compare it with a stronger treatment of the same original. Check faces, labels, and other important details near the edges before choosing a result.

**Can fal Vignette brighten dark corners?**

Its documented effect adds edge darkening. Choose a tool designed for brightening or exposure correction when that is your goal.

**What should I ask my agent to do with fal Vignette?**

Specify the image, the intended strength of the edge darkening, and what to check afterward. For example: apply a light vignette to this portrait, then compare the face and corners with the original.

