Generate image with Nano Banana Pro
Google Nano Banana Pro (Gemini 3 Pro Image) — professional asset production with advanced reasoning, precise instruction-based editing, and multi-reference composition from up to 9 reference images. Billing: 120 credits per image at 1K/2K, 180 at 4K.
Asynchronous. Returns a job id (the image is not in this response). Poll GET /v1/images/{id} until status is succeeded — the generated image URLs are in that response’s images array (each { url, position }).
Authorizations
API key as a bearer token: Authorization: Bearer bpx_live_xxx
Body
Text description of the image to generate.
Output aspect ratio.
1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 Number of images to generate.
1 <= x <= 4Optional reference images (up to 9) for image editing and multi-reference composition. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Omit for text-to-image.
9Output resolution tier. 1K/2K bill 120 credits per image; 4K bills 180.
1K, 2K, 4K