# BananaHub API

> Asynchronous image generation API for NanoBanana, NanoBanana 2, and NanoBanana Pro.

## Docs

- [Get balance](https://docs.bananahub.io/api-reference/get-balance.md): Check your account's available balance.
- [Get job](https://docs.bananahub.io/api-reference/get-job.md): Poll a job for its status and result.
- [Image-to-Image](https://docs.bananahub.io/api-reference/nanobanana-2/image-to-image.md): NanoBanana 2 — generate an image from a prompt and input image URLs at 1K, 2K, or 4K.
- [Text-to-Image](https://docs.bananahub.io/api-reference/nanobanana-2/text-to-image.md): NanoBanana 2 — generate an image from a text prompt at 1K, 2K, or 4K.
- [Image-to-Image](https://docs.bananahub.io/api-reference/nanobanana-pro/image-to-image.md): NanoBanana Pro — generate an image from a prompt and input image URLs at 1K, 2K, or 4K.
- [Text-to-Image](https://docs.bananahub.io/api-reference/nanobanana-pro/text-to-image.md): NanoBanana Pro — generate an image from a text prompt at 1K, 2K, or 4K.
- [Image-to-Image](https://docs.bananahub.io/api-reference/nanobanana/image-to-image.md): NanoBanana — generate a 1K image from a prompt and input image URLs.
- [Text-to-Image](https://docs.bananahub.io/api-reference/nanobanana/text-to-image.md): NanoBanana — generate a 1K image from a text prompt.
- [Authentication](https://docs.bananahub.io/authentication.md): Authenticate requests with a bearer API key.
- [Aspect ratios](https://docs.bananahub.io/concepts/aspect-ratios.md): Supported aspect ratios per model.
- [Errors](https://docs.bananahub.io/concepts/errors.md): HTTP status codes returned by the API.
- [Jobs & polling](https://docs.bananahub.io/concepts/jobs.md): Lifecycle of an asynchronous generation job.
- [Models](https://docs.bananahub.io/concepts/models.md): Choose between NanoBanana, NanoBanana 2, and NanoBanana Pro.
- [Resolutions](https://docs.bananahub.io/concepts/resolutions.md): Output resolution selection for NanoBanana 2 and Pro.
- [Webhooks](https://docs.bananahub.io/concepts/webhooks.md): Get notified when a job reaches a terminal state.
- [Introduction](https://docs.bananahub.io/index.md): Asynchronous image generation across three NanoBanana models.
- [Quickstart](https://docs.bananahub.io/quickstart.md): Create a generation and download the result in two requests.

## OpenAPI Specs

- [openapi](https://docs.bananahub.io/api-reference/openapi.json)