·Quickstart

Quickstart

Get up and running with the NanoBanana API in minutes. No SDK required — it's plain HTTP.

Create your account

Sign up at apinanobanana.com and receive 100 free credits — no credit card required. Each credit maps to roughly one standard image generation.

Generate an API key

Go to Dashboard → API Keys and click Create new key. Copy and store it somewhere safe — it won't be shown again.

Your key format:

nb_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Make your first request

Send a POST request to the generate endpoint. The API responds synchronously — no polling needed.

Tip

The prompt field supports up to 2,000 characters. More detailed prompts produce significantly better results.

Handle the response

The response includes both image_url (hosted for 7 days) and image_base64 (for immediate use). Display or save whichever is more convenient.

Next steps

Base URL

bash

# No SDK needed — plain HTTP
curl https://api.apinanobanana.com/v1/images/generate

Step 3 · cURL 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 futuristic city at sunset, photorealistic",
    "resolution": "1K",
    "aspect_ratio": "16:9"
  }'

Step 3 · Response 200 OK

json

{
  "id": "gen_550e8400e29b",
  "status": "completed",
  "image_url": "https://storage.apinanobanana.com/...",
  "image_base64": "iVBORw0KGgoAAAANS...",
  "credits_used": 40,
  "credits_remaining": 60,
  "created_at": "2026-04-10T12:00:00Z"
}

Python example

python

import requests

response = requests.post(
    "https://api.apinanobanana.com/v1/images/generate",
    headers={"Authorization": "Bearer nb_sk_sua_chave_aqui"},
    json={
        "model": "nano-banana-2",
        "prompt": "A futuristic city at sunset",
        "resolution": "1K",
    }
)

data = response.json()
print(data["image_url"])

Base URL

bash

# No SDK needed — plain HTTP
curl https://api.apinanobanana.com/v1/images/generate

Step 3 · cURL 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 futuristic city at sunset, photorealistic",
    "resolution": "1K",
    "aspect_ratio": "16:9"
  }'

Step 3 · Response 200 OK

json

{
  "id": "gen_550e8400e29b",
  "status": "completed",
  "image_url": "https://storage.apinanobanana.com/...",
  "image_base64": "iVBORw0KGgoAAAANS...",
  "credits_used": 40,
  "credits_remaining": 60,
  "created_at": "2026-04-10T12:00:00Z"
}

Python example

python

import requests

response = requests.post(
    "https://api.apinanobanana.com/v1/images/generate",
    headers={"Authorization": "Bearer nb_sk_sua_chave_aqui"},
    json={
        "model": "nano-banana-2",
        "prompt": "A futuristic city at sunset",
        "resolution": "1K",
    }
)

data = response.json()
print(data["image_url"])