Back to home

API

Generate images from your own code with the Nano Banana 2 Pro API: one endpoint for Nano Banana, GPT Image and Seedream models, billed in credits.

Last updated: 2026-11-21

Access

API access is included with the Ultimate plan. Create a key in Settings → API Keys and send it as a bearer token. Keys stop working if the plan no longer includes API access. Keep keys secret — anyone with a key spends your credits.

Authorization: Bearer sk-...

Jobs cost the same credits as in the studio, use the same resolution and Beast mode limits as your plan, and are refunded automatically if a model fails.

Start a job

POST /api/v1/images

FieldTypeNotes
model or modelsstring / string[]e.g. nano-banana-2-1; several models = Beast mode (up to 8 on Ultimate); auto picks the best fit
promptstringrequired, up to 3,000 characters
referencesstring[]up to 8 public https:// image URLs
resolution1K | 2K | 4Ksnapped to what each model supports
aspectRatiostringe.g. 1:1, 16:9, 9:16
relaxbooleanRelax mode on Nano Banana / 2 / Pro — no credits, slower, hourly limit
visibilitypublic | privatePrivate Mode is on by default for your plan
curl https://probanana.net/api/v1/images \
  -H "Authorization: Bearer $NBA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"models":["nano-banana-2-1","gpt-image-2-5-flare"],"prompt":"A ceramic mug on a sunlit desk","resolution":"2K"}'

The response (201) is { "data": [ { "id", "model", "status", "credits", ... } ] } — one job per model.

Poll a job

GET /api/v1/images/{id} returns { "data": { "status", "outputs": [url], "error" } }. status is pending, processing, success or failed. Poll every few seconds; most images finish in 10–60 seconds.

Models

nano-banana, nano-banana-2, nano-banana-2-1, nano-banana-pro, gpt-image-2, gpt-image-2-5-flare, gpt-image-2-5-sunburst, seedream-4-5, seedream-5-lite, seedream-5-pro, or auto.

Errors

Errors return { "error": { "message" } } with 401 (bad key), 403 (plan has no API access), 402 (not enough credits), 400 (invalid request or plan limit) or 429 (too many requests).