[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Nano Banana Pro Edit](https://spiral.ai/integrations/gemini-cli/nano-banana-pro-edit)

# How to Use Nano Banana Pro Edit in Gemini CLI

Use Nano Banana Pro Edit to revise product photos, translate artwork, or turn sketches into mockups. Unlike Nano Banana Pro Text to Image, its main job starts with an existing visual.

|  |  |
| --- | --- |
| Model | Nano Banana Pro Edit |
| Available through | fal |
| Category | Image |
| Price | `resolution`: 1K (default) $0.195, 2K $0.195, 4K $0.39 per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Nano Banana Pro Edit in Gemini CLI

- Use Nano Banana Pro Edit to revise public/images/product.png. Place the product on a wood desk beside a window with soft morning light; use the original image as the product reference.
- Use Nano Banana Pro Edit to replace the English headline in assets/poster.png with the approved Spanish headline in locales/es.json. Request 2K output and inspect the lettering against the source text.
- Remove the background from the photo I attach with Nano Banana Pro Edit and give me a transparent PNG. Save the result in ./assets.
- Use Nano Banana Pro Edit to clean up these product shots so they sit on pure white.
- Edit this image with Nano Banana Pro Edit: keep the subject, swap the background for a sunlit studio.

## How to set up Nano Banana Pro Edit 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 Nano Banana Pro 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": "fal-ai/gemini-3-pro-image-preview/edit",
    "input": {
      "prompt": "make a photo of the man driving the car down the california coastline"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Nano Banana Pro Edit on Spiral, shows the price and runs it.

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

## Nano Banana Pro Edit tools and prices

- [Gemini 3 Pro Image Preview · Image Editing](https://spiral.ai/tools/fal/fal-ai/gemini-3-pro-image-preview/edit) (fal): `resolution`: 1K (default) $0.195, 2K $0.195, 4K $0.39 per image. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_urls |  | — | The URLs of the images to use for image-to-image generation or image editing. |
| history |  | — | Previous native user/model turns. Replay a returned conversation's messages unchanged, including thought signatures; the current prompt is appended as a new user turn. |
| context |  | — | Ordered text, original images, PDF or UTF-8 text documents appended to the current prompt. Uses a native provider. Images count toward the total 14-reference limit. |
| return_history |  | false | Return reusable native conversations with original image parts and provider thought signatures. Uses a native provider. Each generated conversation is independent; send its messages as history for the next turn. |
| thinking_level |  | — | Thinking effort. Pro Image supports only high; omit to retain its provider default. An explicit level requests summaries unless include_thoughts overrides it. Thinking cannot be disabled. |
| image_passthrough |  | false | Send reference images and return provider images without resizing or re-encoding, preserving transparency and metadata. Uses direct Google or Vertex APIs; the returned image format may differ from output_format. |

## What can you do with Nano Banana Pro Edit in Gemini CLI?

Turn project briefs and documentation into posters, diagrams, and visual concepts with Nano Banana Pro. A coding agent can gather the relevant project context and prepare a specific image brief with approved text.

### Product photo revisions

Start with a product photo and describe a specific change to its setting or composition. Compare the result with the original before using it.

### Translation inside existing artwork

Start with an existing poster or package design and replace its wording with approved translated copy. Review the result for lettering and layout changes.

### Sketches developed into product mockups

Use a product sketch as the starting image and describe the materials, finish, and presentation needed for a visual concept.

### Revisions to diagrams and posters

Start with an existing graphic and request a focused change, such as replacing a heading or moving a label. Check spelling and placement after the edit.

## Overview

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

## Nano Banana Pro Edit in other agents

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

## More Gemini CLI guides

- [Nano Banana Pro](https://spiral.ai/integrations/gemini-cli/nano-banana-pro)
- [Nano Banana Pro Image Editing](https://spiral.ai/integrations/gemini-cli/nano-banana-pro-image-editing)
- [Nano Banana Edit](https://spiral.ai/integrations/gemini-cli/nano-banana-edit)
- [Nano Banana Pro Text to Image](https://spiral.ai/integrations/gemini-cli/nano-banana-pro-text-to-image)
- [Nano Banana 2.1 Text to Image](https://spiral.ai/integrations/gemini-cli/nano-banana-2-1-text-to-image)
- [Object Removal](https://spiral.ai/integrations/gemini-cli/object-removal)

## Questions about Nano Banana Pro Edit in Gemini CLI

**Can Gemini CLI use Nano Banana Pro Edit?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Nano Banana Pro Edit like any built-in tool.

**How much does Nano Banana Pro Edit cost in Gemini CLI?**

`resolution`: 1K (default) $0.195, 2K $0.195, 4K $0.39 per image. Billed on `num_images`, default 1. 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 Nano Banana Pro Edit in Gemini CLI?**

No. Spiral runs Nano Banana Pro Edit on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Nano Banana Pro Edit in Gemini CLI?**

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

**Does Gemini CLI wait while Nano Banana Pro Edit runs?**

Nano Banana Pro Edit runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.

**What is Nano Banana Pro good at?**

Posters with readable headlines, labeled diagrams, product mockups, and multilingual graphics are useful starting points. Give it a concrete brief with the exact wording and layout you want.

**How large can Nano Banana Pro images be?**

Nano Banana Pro supports 1K, 2K, and 4K output. Choose the output size deliberately rather than asking for a vague description such as high resolution.

**Can Nano Banana Pro write text inside an image?**

Yes, including text for posters and diagrams. Small lettering and long paragraphs remain weak spots, so keep essential copy short and inspect it before use.

**Can Nano Banana Pro make graphics in different languages?**

Yes, it can generate localized text and translate text inside images. Supply the approved wording when exact phrasing matters.

**How should I write a Nano Banana Pro prompt?**

Write a complete description of the scene instead of a string of keywords. Include the subject, intended use, composition, lighting, and exact text so the brief leaves fewer decisions unspecified.

