Nano Banana 2.1

ID:google/nano-banana-2.1

Nano Banana 2.1 image generation API by Google — the Gemini Flash image model upgraded for visual design, editing and subject consistency, up to 4K with 14 reference images.

Nano Banana 2.1Gemini ImageGoogleImage Editing4K

Overview

Nano Banana 2.1 image generation API by Google — the Gemini Flash image model upgraded for visual design, editing and subject consistency, up to 4K with 14 reference images.

Authentication

All API requests require a valid API key passed via the Authorization header using the Bearer scheme.

Quickstart

Credentials

Set the RUNBASE_API_KEY environment variable.

Shell

export RUNBASE_API_KEY=your-api-key

Create a run

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2.1",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Runs

Runs are processed asynchronously. Submit a request, then poll for the result.

Create a run

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2.1",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Get run status

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Get result

Poll the status endpoint until status is "succeeded", then read output.urls from the response.

Input Schema

Parameter	Type	Required	Description
prompt	string	Required	Prompt
aspect_ratio	string	Optional	Aspect ratioOptions: `1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto`
resolution	string	Optional	ResolutionOptions: `1K2K4K`
image_urls	string[]	Optional	Reference images

Output Schema

Field	Type	Description
urls	string[]	Generated output URLs

Errors

The API uses standard HTTP status codes to indicate success or failure.

Status Code	Description
400	Invalid request - missing or malformed parameters
401	Authentication failed - missing or invalid API key
402	Insufficient credits
403	Forbidden - IP not allowed, account banned, or API key credit limit exceeded
404	Run not found
429	Rate limit exceeded
500	Internal server error