Skip to main content
Create an asynchronous image-to-image generation with NanoBanana (fast model) from URLs. Returns 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

Returns 202 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.