202 Accepted with a job_id — poll GET /jobs/{job_id} until
the job is done or failed.
NanoBanana always outputs 1K. The
resolution field is not accepted and supported aspect
ratios are a subset — auto is not supported. See Aspect ratios.Headers
string
required
Bearer <YOUR_API_KEY>. See Authentication.string
Optional. Replaying the same key returns the original
job_id without creating a duplicate job
or charging again.Body
string
required
Generation prompt. Minimum length 1. Null bytes are stripped.
string
required
Output aspect ratio. NanoBanana supports a subset — see Aspect ratios.
string[]
required
1–14 image URLs. Each must start with
http:// or https://.Input image limits — 1–14 images per request, up to 200 MB total across all input images.
Response
Returns202 Accepted.
string
UUID of the created job.
string
Always
queued on creation.string
Relative path to poll for status and result.
A
422 is returned when an input URL can’t be fetched or the inputs exceed the size limit. See
Errors.