[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Nano Banana 2.1 Edit](https://spiral.ai/integrations/claude-code/nano-banana-2-1-edit)

# How to Use Nano Banana 2.1 Edit in Claude Code

Rework product photos, combine references, or turn a sketch into a finished image. Unlike Nano Banana 2.1 Text to Image, Nano Banana 2.1 Edit uses existing visual material to guide the result.

|  |  |
| --- | --- |
| Model | Nano Banana 2.1 Edit |
| Available through | fal |
| Category | Image |
| Price | $0.0514 per 1K image ($0.0771 at 2K, $0.173 at 4K). Prompt: $2.29 per 1M tokens. Reasoning: $11.47 per 1M tokens. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Nano Banana 2.1 Edit in Claude Code

- Use Nano Banana 2.1 Edit to rework the product photo in the project's assets into a 4:5, 2K winter scene. Preserve the product shape and label, and compare the output with the original.
- Use Nano Banana 2.1 Edit on the project's room sketch to create a 16:9, 2K concept render. Preserve the window and furniture positions; use pale oak, white plaster, and afternoon window light.
- Remove the background from the photo I attach with Nano Banana 2.1 Edit and give me a transparent PNG. Save the result in ./assets.
- Use Nano Banana 2.1 Edit to clean up these product shots so they sit on pure white.
- Edit this image with Nano Banana 2.1 Edit: keep the subject, swap the background for a sunlit studio.

## How to set up Nano Banana 2.1 Edit in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude 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 Nano Banana 2.1 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": "google/nano-banana-2.1/edit",
    "input": {
      "prompt": "make a photo of the man driving the car down the california coastline"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Nano Banana 2.1 Edit on Spiral, shows the price and runs it.

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

## Nano Banana 2.1 Edit tools and prices

- [Nano Banana 2.1 Edit](https://spiral.ai/tools/fal/google/nano-banana-2.1/edit) (fal): $0.0514 per 1K image ($0.0771 at 2K, $0.173 at 4K). Prompt: $2.29 per 1M tokens. Reasoning: $11.47 per 1M tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| num_images | 1 to 4 | 1 | The number of images to generate. |
| seed |  | — | The seed for the random number generator. |
| aspect_ratio | auto, 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16, 4:1, 1:4, 8:1, 1:8 | auto | The aspect ratio of the generated image. Supports extreme ratios: 4:1, 1:4, 8:1, 1:8. |
| output_format | jpeg, png, webp | png | The format of the generated image. |
| safety_tolerance | 1, 2, 3, 4, 5, 6 | 4 | The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. |
| image_urls |  | — | The URLs of the images to use for image-to-image generation or image editing. Optional when `video_url` or `pdf_url` is provided. |

## What can you do with Nano Banana 2.1 Edit in Claude Code?

Turn project briefs into diagrams, campaign images, and illustrated concepts with Nano Banana 2.1. A coding agent can use the project's copy and design guidance to write specific visual instructions and save the results alongside the work.

### Event posters

Create a poster from an event brief or revise existing artwork. Supply the final headline, date, and location, then check every rendered word.

### Illustrated explanations

Turn a written process into a labeled diagram, or revise an existing diagram. Provide verified facts and check arrows, labels, and spatial relationships.

### Campaign banners

Develop a banner from a written concept or adapt existing campaign art. Specify the placement and keep important text away from the edges.

### Storyboard planning

Visualize a short scene sequence from a script, or develop it from reference artwork. Describe each panel separately and check continuity.

### Product scenes

Place an existing product photo in a seasonal setting. Request that its shape and label stay consistent, then compare the result with the source.

### Sketch development

Turn a rough sketch into a finished architectural, product, or set concept. Explain the intended materials and lighting while identifying the layout to preserve.

### Targeted image corrections

Mark the region that needs changing and describe its replacement. Ask for the marks to disappear and inspect the surrounding image for unintended changes.

### Photo restyling

Rework a photograph as watercolor, clay, or another specified medium. State which pose, composition, and colors should remain recognizable.

## Overview

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

## Nano Banana 2.1 Edit in other agents

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

## More Claude Code guides

- [Nano Banana 2.1](https://spiral.ai/integrations/claude-code/nano-banana-2-1)
- [Nano Banana 2.1 Text to Image](https://spiral.ai/integrations/claude-code/nano-banana-2-1-text-to-image)
- [Nano Banana 2 Text to Image fal](https://spiral.ai/integrations/claude-code/nano-banana-2-text-to-image-fal)
- [Nano Banana Edit](https://spiral.ai/integrations/claude-code/nano-banana-edit)
- [Nano Banana 2 Text to Image](https://spiral.ai/integrations/claude-code/nano-banana-2-text-to-image)
- [Nano Banana Pro](https://spiral.ai/integrations/claude-code/nano-banana-pro)

## Questions about Nano Banana 2.1 Edit in Claude Code

**Can Claude Code use Nano Banana 2.1 Edit?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Nano Banana 2.1 Edit like any built-in tool.

**How much does Nano Banana 2.1 Edit cost in Claude Code?**

$0.0514 per 1K image ($0.0771 at 2K, $0.173 at 4K). Prompt: $2.29 per 1M tokens. Reasoning: $11.47 per 1M tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need a fal account to use Nano Banana 2.1 Edit in Claude Code?**

No. Spiral runs Nano Banana 2.1 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 2.1 Edit in Claude Code?**

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

**Does Claude Code wait while Nano Banana 2.1 Edit runs?**

Nano Banana 2.1 Edit runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.

**What is Nano Banana 2.1 useful for?**

Use it for visual briefs with a clear composition: posters, illustrated explanations, campaign imagery, and storyboards. Give it the intended placement, exact wording, and positions of the main elements.

**Which resolution should I choose?**

Use 2K or 4K when small lettering matters. Small text can blur at 1K, so inspect the actual output before using it.

**Can Nano Banana 2.1 make wide banners?**

Yes, it supports shapes as wide as 8:1 and as tall as 1:8. Specify where the subject and wording belong so the composition fits the placement.

**How should I prompt Nano Banana 2.1?**

Describe the purpose, subject, visual style, lighting, and composition. Put the exact on-image wording in quotes and state where it should appear.

**Can I trust its diagrams and spatial layouts?**

Check facts, labels, and positions before using the image. Google lists factuality and 3D reasoning as limitations and notes occasional confusion between left and right.

