Gemini-native Nano Banana image generation and editing across Nano Banana, Nano Banana 2, and Nano Banana Pro. Use when you need text-to-image, image-to-image edits, repeated local references, batch generation, dry-run request inspection, or a custom Gemini-compatible base URL such as a self-hosted

Nano Banana A single Python entrypoint for Gemini native Nano Banana image generation and editing, with model aliases, strict option validation, batch runs, and custom endpoint support. Workflow 1. Open [references/config.md](./references/config.md) to choose environment variables and override order. 2. Open [references/models and api.md](./references/models and api.md) to pick the right Nano Banana tier and check model specific constraints. 3. Prefer gemini 3.1 flash image preview ( nanobanana 2 ) unless you need either the fastest low cost default ( nanobanana ) or the highest fidelity reasoning model ( nanobanana pro ). 4. Run scripts/nanobanana.py generate for one request or scripts/nanobanana.py batch for repeated variants. 5. Add dry run first when the main risk is the payload shape, endpoint, or model specific option support. 6. Pass base url or GEMINI BASE URL when you need a custom Gemini compatible gateway. 7. Add save response <path on generate when you need the raw JSON body for debugging. Commands Single text to image request: Edit an existing image with two local references: Use a custom Gemini compatible gateway: Batch generate five variants: Inspect the final request without sending it: Rules model accepts the aliases nanobanana , nanobanana 2 , and nanobanana pro , or an exact Gemini model ID. nanobanana resolves to gemini 2.5 flash image , nanobanana 2 resolves to gemini 3.1 flash image preview , and nanobanana pro resolves to gemini 3 pro image preview . image size is only valid on Gemini 3 image models; nanobanana rejects size . 512 resolution is only valid on nanobanana 2 . Process environment variables override .env ; CLI flags override both. Never print secrets. generate accepts repeated input image paths for image editing or multi reference generation. base url should point to the Gemini API root such as https://generativelanguage.googleapis.com/v1beta , not directly to /models/... . auth mode auto uses x goog api key for the official Google endpoint and sends both Authorization: Bearer and x goog api key for custom endpoints to maximize gateway compatibility. Resources Script: [scripts/nanobanana.py](./scripts/nanobanana.py) Config reference: [references/config.md](./references/config.md) Models and API reference: [references/models and api.md](./references/models and api.md)