---

name: gemini-api description: Google Gemini 3 Pro Image API reference. Covers text-to-image, editing, reference images, aspect ratios, and error handling.

plugin: nanobanana updated: 2026-01-20

Gemini Image API Reference

Quick Start

Copy# Set API key
export GEMINI_API_KEY="your-key"

# Generate image
uv run python main.py output.png "A minimal 3D cube"

API Key Setup

1. Visit: https://makersuite.google.com/app/apikey
2. Create new API key
3. Set environment variable:

   Copyexport GEMINI_API_KEY="your-api-key"
   

Supported Models

Aspect Ratios

CLI Flags

Error Codes

Retry Behavior

The script automatically retries on transient errors:

• Rate limits (429)
• Server errors (502, 503)
• Connection timeouts
• Network errors

Retry uses exponential backoff: 1s, 2s, 4s, 8s, etc. Maximum retries configurable with --max-retries (default: 3)

Best Practices

1. Prompts: Be specific about style, lighting, composition
2. Styles: Use markdown templates for consistent results
3. References: Provide visual examples for style matching
4. Batch: Generate variations to pick the best
5. Iteration: Edit results to refine
6. Retries: Increase --max-retries for unreliable connections