Spiral gives your agent every tool with one account. Browse the tools →

Claude Code · ImageReleased 2025-08-26

How to Use Nano Banana in Claude Code

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.

Prompts to try with Nano Banana in Claude Code

Copy an example into Claude Code, or ask in your own words.

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.

Nano BananaClaude Code
Try asking
  • 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 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.

    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.

    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.

    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: Claude Code finds Nano Banana on Spiral, shows the price and runs it.

Nano Banana providers and prices

Spiral runs Nano Banana through fal. Open a card for today's price, with every fee included.

falImage

Settings you can ask for

Nano Banana works from your prompt. Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Number of images1 to 41

The number of images to generate.

Seeda whole number

The seed for the random number generator.

Aspect ratio21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4 and 2 more1:1

The aspect ratio of the generated image.

Output formatjpeg, png, or webppng

The format of the generated image.

Safety tolerance1 to 64

The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.

Limit generationson or offon

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.

Every API field of Nano Banana · Text to Image is on its tool page: open its card above.

What can you do with Nano Banana in Claude Code?

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.

Questions about Nano Banana in Claude Code

Can Claude Code use Nano Banana?

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

How much does Nano Banana cost in Claude Code?

$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 Claude Code plan is separate.

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

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 Claude Code?

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

Does Claude Code wait while Nano Banana runs?

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

Get started

Start using Nano Banana in Claude Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude Code:

Set up Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options