Text to Image

Generate an image from a text prompt using any of the NanoBanana models. Returns synchronously with the image in image_base64 or a hosted image_url.

Body parameters

modelstringrequired

"nano-banana" | "nano-banana-2" | "nano-banana-pro"

promptstringrequired

Text description of the image (max 2000 chars). More detailed prompts produce better results.

aspect_ratiostringoptional

"1:1" | "16:9" | "9:16" | "4:3" | "3:4" — defaults to "1:1"

resolutionstringoptional

"1K" | "2K" | "4K" — only available for nano-banana-2 and nano-banana-pro

nintegeroptional

Number of images to generate. Currently only 1 is supported.

Response fields

idstring

Unique generation ID with prefix gen_

modelstring

The model used for this generation

image_urlstring

Publicly hosted URL of the generated image (valid for 7 days)

image_base64string

Base64-encoded PNG data

credits_usedinteger

Credits deducted for this request

credits_remaininginteger

Your credit balance after this request

Error codes

400

bad_request

Missing or invalid parameters

401

unauthorized

Invalid or missing API key

402

insufficient_credits

Not enough credits

429

rate_limited

Too many requests — slow down

Request

bash

curl -X POST https://api.apinanobanana.com/v1/images/generate \
  -H "Authorization: Bearer nb_sk_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "A majestic lion in the savanna at golden hour, photorealistic",
    "resolution": "2K",
    "aspect_ratio": "16:9"
  }'

Response · 200 OK

json

{
  "id": "gen_a1b2c3d4",
  "model": "nano-banana-2",
  "image_url": "https://storage.apinanobanana.com/user123/1712678400000.png",
  "image_base64": "iVBORw0KGgoAAAANS...",
  "credits_used": 60,
  "credits_remaining": 940,
  "created_at": "2026-04-09T17:00:00Z"
}

Error · 402 Payment Required

json

{
  "error": "insufficient_credits",
  "message": "You don't have enough credits for this request.",
  "credits_required": 60,
  "credits_available": 10
}

Request

bash

curl -X POST https://api.apinanobanana.com/v1/images/generate \
  -H "Authorization: Bearer nb_sk_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "A majestic lion in the savanna at golden hour, photorealistic",
    "resolution": "2K",
    "aspect_ratio": "16:9"
  }'

Response · 200 OK

json

{
  "id": "gen_a1b2c3d4",
  "model": "nano-banana-2",
  "image_url": "https://storage.apinanobanana.com/user123/1712678400000.png",
  "image_base64": "iVBORw0KGgoAAAANS...",
  "credits_used": 60,
  "credits_remaining": 940,
  "created_at": "2026-04-09T17:00:00Z"
}

Error · 402 Payment Required

json

{
  "error": "insufficient_credits",
  "message": "You don't have enough credits for this request.",
  "credits_required": 60,
  "credits_available": 10
}