SKILL.md
$27
python .\skills\nanobanana\scripts\nanobanana.py generate `
--prompt "A retro-futurist product hero illustration for a developer tool" `
--output .\out\hero.png `
--model nanobanana-2 `
--ratio 16:9 `
--size 2K
Edit an existing image with two local references:
python .\skills\nanobanana\scripts\nanobanana.py generate `
--prompt "Turn these references into a clean launch poster with legible title text" `
--input-image .\refs\subject.png `
--input-image .\refs\background.png `
--output .\out\poster.png `
--model nanobanana-pro `
--ratio 4:5 `
--size 2K
Use a custom Gemini-compatible gateway:
python .\skills\nanobanana\scripts\nanobanana.py generate `
--prompt "A bold mascot sticker pack" `
--output .\out\stickers.png `
--base-url http://your-gateway.example.com/v1beta `
--auth-mode bearer
Batch-generate five variants:
python .\skills\nanobanana\scripts\nanobanana.py batch `
--prompt "Minimal app icon for a PDF workflow product" `
--count 5 `
--dir .\out\icons `
--prefix icon `
--model nanobanana `
--ratio 1:1
Inspect the final request without sending it:
python .\skills\nanobanana\scripts\nanobanana.py generate `
--prompt "An editorial illustration of AI agents at work" `
--model nanobanana-2 `
--output .\out\agents.png `
--dry-run
Rules
--modelaccepts the aliasesnanobanana,nanobanana-2, andnanobanana-pro, or an exact Gemini model ID.
nanobananaresolves togemini-2.5-flash-image,nanobanana-2resolves togemini-3.1-flash-image-preview, andnanobanana-proresolves togemini-3-pro-image-preview.
image_sizeis only valid on Gemini 3 image models;nanobananarejects--size.
512resolution is only valid onnanobanana-2.
- Process environment variables override
.env; CLI flags override both.
- Never print secrets.
generateaccepts repeated--input-imagepaths for image editing or multi-reference generation.
--base-urlshould point to the Gemini API root such ashttps://generativelanguage.googleapis.com/v1beta, not directly to/models/....
--auth-mode autousesx-goog-api-keyfor the official Google endpoint and sends bothAuthorization: Bearerandx-goog-api-keyfor custom endpoints to maximize gateway compatibility.
Resources
- Script: scripts/nanobanana.py
- Config reference: references/config.md
- Models and API reference: references/models-and-api.md