How to Use Nano Banana 2.1 in Claude Code
Nano Banana 2.1 creates product scenes, illustrated explainers, and posters you can refine through follow-up edits. Compared with Nano Banana 2, Google reports better visual design, subject consistency, and more natural-looking images.
Prompts to try with Nano Banana 2.1 in Claude Code
Copy an example into Claude Code, or ask in your own words.
Read the homepage copy and design tokens, then use Nano Banana 2.1 to create a 2K landscape illustration for our gardening app. Show a balcony herb garden in a cut-paper style, using the project's palette and leaving the left third open for the page headline.
Use Nano Banana 2.1 with the ceramic mug photo in our assets directory. Create a 2K square product scene on a wooden breakfast table; preserve the handle, glaze, and proportions, and add no text.
Read the three onboarding steps in the project and use Nano Banana 2.1 to create one 2K illustrated overview. Use only the exact labels "Choose a plant", "Set a reminder", and "Watch it grow", with a clear reading order.
Use Nano Banana 2.1 to revise our existing garden illustration. Change the background from midday to early evening while preserving the plants, containers, framing, and illustration style; return a 2K image.
Use Nano Banana 2.1 with our mascot reference to create a 1K square illustration of the mascot watering a seedling. Call the mascot Robin, retain its red scarf and round glasses, and leave the background plain for the empty-state screen.
How to set up Nano Banana 2.1 in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- 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
- 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
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Nano Banana 2.1
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": "gemini", "model": "gemini-nano-banana-2.1", "input": { "contents": [ {} ] } }'
Then paste one of the prompts above: Claude Code finds Nano Banana 2.1 on Spiral, shows the price and runs it.
Nano Banana 2.1 providers and prices
Spiral runs Nano Banana 2.1 through Gemini and Vertex AI. Open a card for today's price, with every fee included. Name one in your prompt, or let Claude Code pick.
$0.0437 per 1K image ($0.0655 at 2K, $0.147 at 4K). Prompt: $1.95 per 1M tokens. Reasoning: $9.75 per 1M tokens. Google Search: $0.0182 per query.
$0.0437 per 1K image ($0.0655 at 2K, $0.147 at 4K). Prompt: $1.95 per 1M tokens ($0.195 cached). Reasoning: $9.75 per 1M tokens. Google Search: $0.0182 per query.
What can you do with Nano Banana 2.1 in Claude Code?
Create website illustrations and product imagery from the project's design brief with Nano Banana 2.1. Use follow-up edits to refine the selected image before placing it in the interface.
Product photos in new settings
Give Nano Banana 2.1 a product reference and request a kitchen counter, workshop, or outdoor setting. Specify which packaging details, colors, and proportions must stay the same.
Posters with short headlines
Create event or campaign artwork with Nano Banana 2.1 using an exact quoted headline. Keep supporting copy brief and inspect the lettering before publishing.
Illustrated explainers
Turn an approved explanation into a labeled diagram with Nano Banana 2.1. Supply the labels and relationships, then check that the picture matches them.
Recurring characters
Use named character references with Nano Banana 2.1 to illustrate a sequence of scenes. Request one scene at a time and review clothing, facial features, and accessories between images.
Localized campaign artwork
Ask Nano Banana 2.1 to revise an existing design with approved Spanish, French, Japanese, or other supported wording. Specify the text placement and visual details to preserve.
Targeted image revisions
Refine an existing image with Nano Banana 2.1 through specific follow-up requests. Change the background, lighting, or a subject detail, and state what should remain intact.
Website illustrations
Create editorial and product illustrations with Nano Banana 2.1 for landing pages or articles. Describe the placement, composition, and space needed for surrounding page text.
Coordinated campaign images
Use the same reference artwork and visual brief with Nano Banana 2.1 across a product launch. Request each image separately while retaining the palette, subject, and illustration style.
Nano Banana 2.1 success rate and speed on Spiral
Success and speed over the last 24 hours, across every run of these tools on Spiral.
| Tool | Success | Median time | Runs |
|---|---|---|---|
| Nano Banana 2.1 | 38.5% | 26.6s | 26 |
| Nano Banana 2.1 | 95.3% | 26.7s | 684 |
More on Nano Banana 2.1 and Claude Code
Nano Banana 2.1 in other agents
Questions about Nano Banana 2.1 in Claude Code
Can Claude Code use Nano Banana 2.1?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Nano Banana 2.1 like any built-in tool.
How much does Nano Banana 2.1 cost in Claude Code?
$0.0437 per 1K image ($0.0655 at 2K, $0.147 at 4K). Prompt: $1.95 per 1M tokens. Reasoning: $9.75 per 1M tokens. Google Search: $0.0182 per query. 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 Gemini account to use Nano Banana 2.1 in Claude Code?
No. Spiral runs Nano Banana 2.1 on its own Gemini account. You sign in to Spiral once and never paste a key.
How long does it take to set up Nano Banana 2.1 in Claude Code?
About two minutes: add the hosted server, then sign in.
Which provider runs Nano Banana 2.1?
Spiral offers Nano Banana 2.1 through Gemini and Vertex AI. Name one in your prompt, or let Claude Code pick.
Does Claude Code wait while Nano Banana 2.1 runs?
Nano Banana 2.1 runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.
What is Nano Banana 2.1 good at?
Use it for product scenes, posters with short headlines, illustrated diagrams, and images you want to refine through follow-up edits. Google reports improvements in visual design and subject consistency over previous Nano Banana models.
What resolutions can Nano Banana 2.1 generate?
Nano Banana 2.1 supports 1K, 2K, and 4K output. Start with 1K to judge the composition, then try 2K or 4K for the selected design.
Can Nano Banana 2.1 combine reference images?
Yes, it supports up to 14 reference images. Give each important character or object a distinct name and specify what to preserve from each reference.
How should I prompt Nano Banana 2.1 for text in an image?
Put the exact wording in quotation marks and describe where it should appear. Favor short headlines and labels, since Google identifies small text and long paragraphs as weaknesses.
Can Nano Banana 2.1 create images in different languages?
Yes. Google's recommended languages include English, Spanish, French, German, Hindi, Japanese, Korean, and Simplified Chinese; for localized artwork, supply the approved wording and check the rendered text.
Start using Nano Banana 2.1 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 https://spiral.ai/SKILL.md


