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

# How to Use Nano Banana Pro Image Editing in opencode

Use Nano Banana Pro Edit to turn references into product mockups, localized artwork, or detailed compositions. It brings Pro's text rendering and higher resolutions to edits of existing images.

|  |  |
| --- | --- |
| Model | Nano Banana Pro Image Editing |
| Available through | fal |
| Category | Image |
| Price | $0.195 per image at 1K or 2K ($0.39 at 4K). Web search: $0.0195 per request. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Nano Banana Pro Image Editing in opencode

- Use Nano Banana Pro Edit with the project's layout sketch and product photo. Follow the sketch for placement and the photo for product appearance, producing a 2K visual mockup with space for the page's HTML headline.
- Use Nano Banana Pro Edit to adapt the project's campaign artwork using its approved Spanish translation. Preserve the composition and product, replace only the wording, request 2K output, and flag any spelling differences.
- Use Nano Banana Pro Edit with the product photo in the project's assets. Replace the background with a softly lit workshop while preserving the product's shape, color, markings, and camera angle; make the image square.
- Remove the background from the photo I attach with Nano Banana Pro Image Editing and give me a transparent PNG. Save the result in ./assets.
- Use Nano Banana Pro Image Editing to clean up these product shots so they sit on pure white.

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

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

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

## Nano Banana Pro Image Editing tools and prices

- [Nano Banana Pro · Image Editing](https://spiral.ai/tools/fal/fal-ai/nano-banana-pro/edit) (fal): $0.195 per image at 1K or 2K ($0.39 at 4K). Web search: $0.0195 per request.

## 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 Image Editing in opencode?

Create illustrations and visual mockups that fit the project you are building. Use project assets as references, then inspect the results for text errors and unwanted changes.

### Product scenes from reference photos

Place an existing product into different settings while asking to preserve its shape, color, and identifying details. Compare each result with the original photo.

### Posters with exact wording

Use Pro for artwork that includes a headline or short message. Supply the wording in quotes and describe its position and typography.

### Localized campaign artwork

Use Pro Edit to replace text in an existing design with approved translations. Ask to preserve the product, layout, and background.

### Sketches turned into mockups

Give Pro Edit a layout sketch and a product reference to create a visual mockup. Assign a specific role to each reference.

### Explanatory diagrams

Turn supplied notes into a labeled visual with Pro. Review the relationships and labels against the notes before sharing it.

### Photo restyling

Use the editing models to reinterpret a photo as an illustration or change its setting. State which subject details should remain recognizable.

## Overview

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

## Nano Banana Pro Image Editing in other agents

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

## More opencode guides

- [Nano Banana Pro Edit](https://spiral.ai/integrations/opencode/nano-banana-pro-edit)
- [Nano Banana Pro Text to Image](https://spiral.ai/integrations/opencode/nano-banana-pro-text-to-image)
- [Nano Banana Pro](https://spiral.ai/integrations/opencode/nano-banana-pro)
- [Object Removal](https://spiral.ai/integrations/opencode/object-removal)
- [Nano Banana Edit](https://spiral.ai/integrations/opencode/nano-banana-edit)
- [Object Removal Bounding Box](https://spiral.ai/integrations/opencode/object-removal-bounding-box)

## Questions about Nano Banana Pro Image Editing in opencode

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

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

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

$0.195 per image at 1K or 2K ($0.39 at 4K). Web search: $0.0195 per request. 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 Pro Image Editing in opencode?**

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

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

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

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

**When should I choose Nano Banana Pro?**

Choose Pro for text-heavy artwork, detailed compositions, or output above the original model's roughly 1K range. It supports native generation from 1K to 4K.

**Can Nano Banana keep the same person or product across images?**

Maintaining a subject's appearance across edits is a core strength. Use a clear reference and check each result, because consistency is not guaranteed.

**Can it create readable text in other languages?**

Pro can generate multilingual text and translate existing artwork. Provide the exact translated wording when it matters, then check the rendered spelling before using the image.

**How many reference images should I use?**

Google says the original works best with up to three input images. Pro supports up to 14 references, but each reference should have a clear purpose, such as the subject, layout, or background.

**Can I trust the facts in a generated infographic?**

Check every label, number, and relationship against your source material. Pro can misinterpret information or produce incorrect facts even when the graphic looks convincing.

