POST /images/generations, optionally
composing your organization’s trained style, object, person, and
setting models plus a color palette. The default engine is
nano_banana_pro (pass engine to select nano_banana_2).
Asynchronous pattern
Generation is asynchronous.POST /images/generations returns 202 Accepted
immediately with a job id, status, and an estimated_credits figure. Poll
GET /images/generations/{id} until
status is completed (or failed/cancelled), then read the produced images —
each carries a presigned URL valid for 24 hours. Pass a webhook_url to be
notified instead of polling (see Webhooks).
Credits
Each output costs5 credits at 1K, scaling with resolution (1K ×1, 2K ×2,
4K ×4) and multiplied by num_outputs. Costs draw from your organization’s pool;
an exhausted pool returns 402. See Pricing.
Quickstart
A full zero-to-image walkthrough with curl, Python, and TypeScript.