Skip to main content
Create an asynchronous image-to-image generation with NanoBanana Pro (top tier) from URLs. Returns 202 Accepted with a job_id — poll GET /jobs/{job_id} until the job is done or failed.
NanoBanana Pro supports selectable resolution (1K, 2K, 4K) and the full aspect-ratio set, including auto. It uses the unprefixed endpoint path.

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. See Aspect ratios. auto infers the ratio from the first input image.
string[]
required
1–14 image URLs. Each must start with http:// or https://.
string
1K, 2K, or 4K. See Resolutions.
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.