Skip to main content
Create an asynchronous text-to-image generation with NanoBanana (fast model). 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 of the full set — 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.

Response

Returns 202 Accepted.
string
UUID of the created job.
string
Always queued on creation.
string
Relative path to poll for status and result.
See Errors for 401, 402, 403, 422, and 503 responses.