Skip to main content
POST
Nano Banana 2.1
Use nano-banana-2.1 to generate a new image from text or edit with reference images. Each request delivers one image. This model is separate from Nano Banana 2 and does not substitute the older model on failure. 100 SnapGen credits = $1. References have no extra charge. Confirm current availability and prices with GET /v1/models and the live model page.
string
required
Set to nano-banana-2.1.
string
required
A non-empty visual brief of at most 100,000 characters. For edits, describe what to change and what to preserve.
string
default:"1K"
1K, 2K or 4K. This selects the billed resolution tier.
string
default:"auto"
auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5 or 21:9.
integer
default:"1"
This route accepts one image per request. Submit separate requests for variants.
string[]
Optional, up to 16 publicly reachable HTTP(S) URLs or PNG, JPEG and WebP Data URLs. Private, loopback and credentialed URLs are rejected. Data URL images must be valid Base64 and at most 20 MiB decoded per image, with at most 50 MiB decoded in total. The whole JSON request is subject to the gateway request-size cap (default 10 MiB), so use public URLs for larger references.
This route does not support quality, custom pixel sizes, version, masks, video inputs or search controls. Official token-priced fallback is disabled; official_fallback: true is rejected before a billing reservation.

Generate an image

A normal request waits for a terminal result (default 180 seconds). Success returns image URLs:

Edit with a reference

Run asynchronously

Send Prefer: respond-async to receive HTTP 202 immediately. Use Idempotency-Key (1–200 characters) for retries of the same submission. A normal waiting request can also return 202 when the job is still running. Read the gateway task ID and poll GET /v1/tasks/{id} with the same key until succeeded or failed.
The gateway reserves the selected resolution price before submitting the request and settles the delivered image count against that immutable price version. Explicit failure or cancellation releases the reservation. Uncertain or invalid results are held for reconciliation. Repeated status polls do not charge twice. Result URLs are temporary: download successful files promptly and respect any returned expiry time.

Try Nano Banana 2.1

Generate from text or references in the model Playground and compare live rates.