Gemini Image Generation (Nano Banana)

Create and edit high-quality images using Google’s Nano Banana models. Supports text-to-image generation and image editing with multiple aspect ratios and resolutions up to 4K.

Supported Models

Model	Description	Max Resolution
`nano-banana-fast`	Fast generation (default) — balanced quality & speed	1K
`nano-banana-pro`	Professional quality — supports up to 4K	4K
`nano-banana-2`	Latest model — supports extended aspect ratios (1:4, 4:1, 1:8, 8:1)	4K

Features

Text-to-Image

Generate images from text prompts with action: "generate"

Image Editing

Edit existing images using reference URLs with action: "edit"

Flexible Aspect Ratios

21:9, 16:9, 9:16, 4:3, 3:2, 5:4, 1:1, and more — up to 1:8 / 8:1 on nano-banana-2

High Resolution

1K / 2K / 4K output on Pro and 2 models

How to Use

Create an image task

Call POST /gemini/image/generate with your prompt, model, and aspect ratio. You’ll receive a taskId.

Poll for results

Use GET /gemini/task/result?taskId=xxx to poll until status is completed. The result contains the generated image.

Quick Example

curl -X POST "https://api.mountsea.ai/gemini/image/generate" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic city skyline at night, neon lights reflecting on wet streets",
    "action": "generate",
    "model": "nano-banana-pro",
    "aspect_ratio": "16:9",
    "resolution": "2K"
  }'

curl -X POST "https://api.mountsea.ai/gemini/image/generate" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Add snow to the scene",
    "action": "edit",
    "model": "nano-banana-fast",
    "image_urls": ["https://example.com/source.jpg"],
    "aspect_ratio": "1:1"
  }'

curl -X GET "https://api.mountsea.ai/gemini/task/result?taskId=your-task-id" \
  -H "Authorization: Bearer your-api-key"

Aspect Ratios

Ratio	Standard Models	nano-banana-2 Only
1:1, 4:3, 3:2, 5:4, 3:4, 4:5, 16:9, 9:16, 21:9, 2:3	✅	✅
1:4, 4:1, 1:8, 8:1	❌	✅

Resolution Options

nano-banana-fast — fixed 1K resolution
nano-banana-pro — 1K / 2K / 4K
nano-banana-2 — 1K / 2K / 4K

Use nano-banana-2 when you need unusual aspect ratios like 1:8 (vertical banner) or 8:1 (horizontal banner). Use nano-banana-pro for the highest quality output at 4K.

Available Endpoints

Endpoint	Method	Description
`/gemini/image/generate`	POST	Generate or edit images with Nano Banana
`/gemini/task/result`	GET	Shared poll for image and video tasks

Explore the API Documentation

Generate Image — Create or edit images with Nano Banana
Get Task Result — Shared poll for video & image tasks

Looking for Gemini API SDK compatibility? See Gemini Compat to use the official @google/genai library directly.

​Gemini Image Generation (Nano Banana)

​Supported Models

​Features

Text-to-Image

Image Editing

Flexible Aspect Ratios

High Resolution

​How to Use

​Quick Example

​Aspect Ratios

​Resolution Options

​Available Endpoints

​Explore the API Documentation

Gemini Image Generation (Nano Banana)

Supported Models

Features

How to Use

Quick Example

Aspect Ratios

Resolution Options

Available Endpoints

Explore the API Documentation