[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Nano Banana](https://spiral.ai/integrations/codex/nano-banana)

# How to Use Nano Banana in Codex

Use Nano Banana to create illustrations, product concepts, and scene drafts from text. It is Google's original Gemini 2.5 Flash Image model, with roughly 1K output rather than Pro's higher resolutions.

|  |  |
| --- | --- |
| Model | Nano Banana |
| Available through | fal |
| Category | Image |
| Price | $0.05174 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 in Codex

- Use Nano Banana to create a square illustration for this project's empty search state: a librarian looking through an empty card catalog, drawn in ink with two muted colors. Match the palette in the project's styles and include no lettering.
- Generate a product photo with Nano Banana: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
- Make four logo concepts for a coffee brand called "Northline" with Nano Banana.
- Create a 16:9 hero image of a quiet mountain cabin at dusk with Nano Banana.
- Generate a 9:16 poster with Nano Banana for a jazz night called "Blue Hour", deep navy and brass tones.

## How to set up Nano Banana in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

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

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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**: 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",
    "input": {
      "prompt": "An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half,…"
    }
  }'
```

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

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

## Nano Banana tools and prices

- [Nano Banana · Text to Image](https://spiral.ai/tools/fal/fal-ai/nano-banana) (fal): $0.05174 per image. Billed on `num_images`, default 1.

## 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 | 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 | 1:1 | The aspect ratio of the generated image. |
| 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. |
| limit_generations |  | true | Experimental parameter to limit the number of generations from each round of prompting to 1. Set to `True` to to disregard any instructions in the prompt regarding the number of images to generate. |

## What can you do with Nano Banana in Codex?

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 Codex guides](https://spiral.ai/integrations/codex)

## Nano Banana in other agents

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

## More Codex guides

- [NAFNet Denoise](https://spiral.ai/integrations/codex/nafnet-denoise)
- [Nano Banana 2](https://spiral.ai/integrations/codex/nano-banana-2)
- [NAFNet Deblur](https://spiral.ai/integrations/codex/nafnet-deblur)
- [Nano Banana 2 Image Editing](https://spiral.ai/integrations/codex/nano-banana-2-image-editing)
- [Muse Image Text to Image](https://spiral.ai/integrations/codex/muse-image-text-to-image)
- [Nano Banana 2 Image Editing fal](https://spiral.ai/integrations/codex/nano-banana-2-image-editing-fal)

## Questions about Nano Banana in Codex

**Can Codex use Nano Banana?**

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

**How much does Nano Banana cost in Codex?**

$0.05174 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 Codex plan is separate.

**Do I need a fal account to use Nano Banana in Codex?**

No. Spiral runs Nano Banana 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 in Codex?**

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

**Does Codex wait while Nano Banana runs?**

Nano Banana runs in the background. Codex 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.

