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

Gemini CLI · ImageReleased 2025-08-26

How to Use Nano Banana in Gemini CLI

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 Gemini CLI

Copy an example into Gemini CLI, 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 BananaGemini CLI
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 Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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: Gemini CLI 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 Gemini CLI 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 Gemini CLI?

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 Gemini CLI

Can Gemini CLI use Nano Banana?

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

How much does Nano Banana cost in Gemini CLI?

$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 Gemini CLI plan is separate.

Do I need a fal account to use Nano Banana in Gemini CLI?

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 Gemini CLI?

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

Does Gemini CLI wait while Nano Banana runs?

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

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

Paste this into Gemini CLI:

Set up Gemini CLI

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