Documentation
Generate and edit images with Nano Banana through a single asynchronous REST API.
Nano Banana API gives you one image endpoint and routes each request to the selected Nano Banana profile. Every job is asynchronous: you POST a request, receive a taskId, and poll until the task completes.
Base URL
https://nanobanana-api.comUse http://localhost:3000 when running against your local dev server.
Quick map
- Quickstart — submit your first image job with
curlin under five minutes. - Authentication — Bearer API keys and key management.
- API reference — interactive schema for every endpoint.
- Guides — polling, credits & models, errors & refunds.
How a request flows
Submit
POST /api/ai/image/generate with a JSON body describing the prompt, model, and optional parameters.
Receive taskId
The response is { taskId, status: 0, creditsUsed }. Credits are pre-debited up front.
Poll
GET /api/ai/tasks/{taskId} returns the current snapshot. Keep polling while status === 0. Status 1 means completed, 2 means failed.
Download
On success the response contains imageUrls[]. On failure credits are refunded automatically.