[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Nano Banana 2 Image Editing](https://spiral.ai/integrations/opencode/nano-banana-2-image-editing)

# How to Use Nano Banana 2 Image Editing in opencode

Nano Banana 2 Image Editing revises supplied images with written instructions, including changes to backgrounds, lighting, and style. Choose it to develop an existing visual; Nano Banana 2 Text to Image focuses on new compositions.

|  |  |
| --- | --- |
| Model | Nano Banana 2 Image Editing |
| Available through | fal |
| Category | Image |
| Price | `resolution`: 0.5K $0.078, 1K (default) $0.104, 2K $0.156, 4K $0.208 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 2 Image Editing in opencode

- Use Nano Banana 2 Image Editing to revise the existing onboarding illustration in the project. Make the lighting warmer while keeping the composition and character clothing unchanged, then show me the result.
- Use Nano Banana 2 Image Editing to revise our existing event poster with the approved title and date from the project. Keep the lettering large and show the output for a spelling check.
- Remove the background from the photo I attach with Nano Banana 2 Image Editing and give me a transparent PNG. Save the result in ./assets.
- Use Nano Banana 2 Image Editing to clean up these product shots so they sit on pure white.
- Edit this image with Nano Banana 2 Image Editing: keep the subject, swap the background for a sunlit studio.

## How to set up Nano Banana 2 Image Editing in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 Image Editing**: 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.1-flash-image-preview/edit",
    "input": {
      "prompt": "make a photo of the man driving the car down the california coastline",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

Then paste one of the prompts above: opencode finds Nano Banana 2 Image Editing on Spiral, shows the price and runs it.

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

## Nano Banana 2 Image Editing tools and prices

- [Gemini 3.1 Flash Image Preview · Image Editing](https://spiral.ai/tools/fal/fal-ai/gemini-3.1-flash-image-preview/edit) (fal): `resolution`: 0.5K $0.078, 1K (default) $0.104, 2K $0.156, 4K $0.208 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. Optional when at least one of `video_url`, `audio_url`, or `pdf_url` is provided. |
| history |  | — | Previous native Gemini turns, including original parts and thought signatures from conversations. The current prompt starts a new user turn. |
| context |  | — | Ordered text, image, PDF, UTF-8 text-file or video parts appended to the current prompt. Original media bytes are preserved; 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 | minimal, high | — | Controls thinking effort ('minimal' or 'high') and requests thought summaries. Omit to use the provider default ('minimal'); 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 2 Image Editing in opencode?

Create illustrations and explanatory graphics for your project with Nano Banana 2. A coding agent can turn project notes into visual drafts and help review the results before adding them to the interface.

### Social campaign artwork

Develop a campaign image from a written brief or revise a supplied draft. Specify the placement, subject, and short headline before working on alternate compositions.

### Educational diagrams

Turn lesson notes into a labeled illustration, or improve an existing diagram. Keep labels brief and check the relationships between illustrated elements.

### Event poster drafts

Create a poster concept or revise supplied artwork around an approved title and date. Keep detailed event information outside the generated image if it requires small lettering.

### Presentation infographics

Build a visual explanation from verified notes or revise an existing slide graphic. Use a few clear labels instead of embedding paragraphs.

### Localized promotional artwork

Start with an existing promotional image and replace its text with approved translated copy. Review wording, line breaks, and retained design details.

### Background revisions

Revise the setting around a supplied subject to explore a different scene. Inspect the subject afterward for unintended changes.

### Illustration style studies

Use a supplied image as the starting point for a different illustration treatment. Compare the results before choosing a direction.

### Lighting revisions

Adjust the lighting in an existing image through a focused editing request. Change one aspect at a time so the result is easier to evaluate.

## Overview

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

## Nano Banana 2 Image Editing in other agents

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

## More opencode guides

- [Nano Banana 2](https://spiral.ai/integrations/opencode/nano-banana-2)
- [Nano Banana 2 Image Editing fal](https://spiral.ai/integrations/opencode/nano-banana-2-image-editing-fal)
- [Nano Banana](https://spiral.ai/integrations/opencode/nano-banana)
- [Nano Banana 2 Lite](https://spiral.ai/integrations/opencode/nano-banana-2-lite)
- [NAFNet Denoise](https://spiral.ai/integrations/opencode/nafnet-denoise)
- [Nano Banana 2 Text to Image](https://spiral.ai/integrations/opencode/nano-banana-2-text-to-image)

## Questions about Nano Banana 2 Image Editing in opencode

**Can opencode use Nano Banana 2 Image Editing?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Nano Banana 2 Image Editing like any built-in tool.

**How much does Nano Banana 2 Image Editing cost in opencode?**

`resolution`: 0.5K $0.078, 1K (default) $0.104, 2K $0.156, 4K $0.208 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 opencode plan is separate.

**Do I need a fal account to use Nano Banana 2 Image Editing in opencode?**

No. Spiral runs Nano Banana 2 Image Editing 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 Image Editing in opencode?**

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

**Does opencode wait while Nano Banana 2 Image Editing runs?**

Nano Banana 2 Image Editing runs in the background. opencode starts the run, checks on it and gives you the image when it's ready.

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

Use it for visual drafts that combine illustrations and short labels, such as posters, educational diagrams, and infographics. It also supports conversational revisions, so you can develop a design through specific follow-up requests.

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

Nano Banana 2 supports output from 0.5K through 4K, with 1K as the default. Choose the composition as well as the resolution: square, portrait, landscape, and panoramic formats serve different placements.

**Can Nano Banana 2 handle text inside images?**

It can produce and translate text within artwork, but small lettering and long paragraphs remain weaknesses. Keep image copy short and check the spelling before using the result.

**Will Nano Banana 2 preserve a character exactly?**

Character consistency is imperfect. Compare the face, clothing, and distinguishing details after each revision before accepting a sequence of images.

**Can Nano Banana 2 localize artwork?**

Yes, it can translate and localize text within an image. Give it the intended audience and approved wording, then review the translated artwork before publication.

