How to Use Nano Banana 2.1 Edit in Gemini CLI
Rework product photos, combine references, or turn a sketch into a finished image. Unlike Nano Banana 2.1 Text to Image, Nano Banana 2.1 Edit uses existing visual material to guide the result.
Prompts to try with Nano Banana 2.1 Edit in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use Nano Banana 2.1 Edit to rework the product photo in the project's assets into a 4:5, 2K winter scene. Preserve the product shape and label, and compare the output with the original.
Use Nano Banana 2.1 Edit on the project's room sketch to create a 16:9, 2K concept render. Preserve the window and furniture positions; use pale oak, white plaster, and afternoon window light.
Remove the background from the photo I attach with Nano Banana 2.1 Edit and give me a transparent PNG. Save the result in ./assets.
Use Nano Banana 2.1 Edit to clean up these product shots so they sit on pure white.
Edit this image with Nano Banana 2.1 Edit: keep the subject, swap the background for a sunlit studio.
How to set up Nano Banana 2.1 Edit in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI 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 Edit
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": "google/nano-banana-2.1/edit", "input": { "prompt": "make a photo of the man driving the car down the california coastline" } }'
Then paste one of the prompts above: Gemini CLI finds Nano Banana 2.1 Edit on Spiral, shows the price and runs it.
Nano Banana 2.1 Edit providers and prices
Spiral runs Nano Banana 2.1 Edit through fal. Open a card for today's price, with every fee included.
$0.0514 per 1K image ($0.0771 at 2K, $0.173 at 4K). Prompt: $2.29 per 1M tokens. Reasoning: $11.47 per 1M tokens.
Settings you can ask for
Nano Banana 2.1 Edit works from your prompt, image URLs, system prompt, video URL, and PDF URL. Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Number of images | 1 to 4 | 1 | The number of images to generate. |
| Seed | a whole number | The seed for the random number generator. | |
| Aspect ratio | auto, 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5 and 7 more | auto | The aspect ratio of the generated image. Supports extreme ratios: 4:1, 1:4, 8:1, 1:8. |
| Output format | jpeg, png, or webp | png | The format of the generated image. |
| Safety tolerance | 1 to 6 | 4 | The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. |
| Resolution | 1K, 2K, or 4K | 1K | The resolution of the image to generate. |
| Limit generations | on or off | on | Experimental parameter to limit the number of generations from each round of prompting to 1. Set to |
| Enable web search | on or off | off | Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image. |
| Thinking level | minimal, medium, or high | medium | How much the model reasons before generating. Higher levels can improve complex compositions and use more thinking tokens. |
Every API field of Nano Banana 2.1 Edit is on its tool page: open its card above.
What can you do with Nano Banana 2.1 Edit in Gemini CLI?
Turn project briefs into diagrams, campaign images, and illustrated concepts with Nano Banana 2.1. A coding agent can use the project's copy and design guidance to write specific visual instructions and save the results alongside the work.
Event posters
Create a poster from an event brief or revise existing artwork. Supply the final headline, date, and location, then check every rendered word.
Illustrated explanations
Turn a written process into a labeled diagram, or revise an existing diagram. Provide verified facts and check arrows, labels, and spatial relationships.
Campaign banners
Develop a banner from a written concept or adapt existing campaign art. Specify the placement and keep important text away from the edges.
Storyboard planning
Visualize a short scene sequence from a script, or develop it from reference artwork. Describe each panel separately and check continuity.
Product scenes
Place an existing product photo in a seasonal setting. Request that its shape and label stay consistent, then compare the result with the source.
Sketch development
Turn a rough sketch into a finished architectural, product, or set concept. Explain the intended materials and lighting while identifying the layout to preserve.
Targeted image corrections
Mark the region that needs changing and describe its replacement. Ask for the marks to disappear and inspect the surrounding image for unintended changes.
Photo restyling
Rework a photograph as watercolor, clay, or another specified medium. State which pose, composition, and colors should remain recognizable.
Nano Banana 2.1 Edit 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 Edit | 87.3% | 28.1s | 79 |
More on Nano Banana 2.1 Edit and Gemini CLI
Overview
Nano Banana 2.1 Edit in other agents
Questions about Nano Banana 2.1 Edit in Gemini CLI
Can Gemini CLI use Nano Banana 2.1 Edit?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Nano Banana 2.1 Edit like any built-in tool.
How much does Nano Banana 2.1 Edit cost in Gemini CLI?
$0.0514 per 1K image ($0.0771 at 2K, $0.173 at 4K). Prompt: $2.29 per 1M tokens. Reasoning: $11.47 per 1M tokens. 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 2.1 Edit in Gemini CLI?
No. Spiral runs Nano Banana 2.1 Edit 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 2.1 Edit in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Nano Banana 2.1 Edit runs?
Nano Banana 2.1 Edit runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.
What is Nano Banana 2.1 useful for?
Use it for visual briefs with a clear composition: posters, illustrated explanations, campaign imagery, and storyboards. Give it the intended placement, exact wording, and positions of the main elements.
Which resolution should I choose?
Use 2K or 4K when small lettering matters. Small text can blur at 1K, so inspect the actual output before using it.
Can Nano Banana 2.1 make wide banners?
Yes, it supports shapes as wide as 8:1 and as tall as 1:8. Specify where the subject and wording belong so the composition fits the placement.
How should I prompt Nano Banana 2.1?
Describe the purpose, subject, visual style, lighting, and composition. Put the exact on-image wording in quotes and state where it should appear.
Can I trust its diagrams and spatial layouts?
Check facts, labels, and positions before using the image. Google lists factuality and 3D reasoning as limitations and notes occasional confusion between left and right.
Start using Nano Banana 2.1 Edit 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 https://spiral.ai/SKILL.md


