API docs / Image models
Nano Banana 2 API
Generate and edit images from text prompts with fast processing optimized for high-volume use cases. Transform existing images by changing backgrounds, swapping colors, or adjusting styles using up to 14 reference images for style transfer and complex editing tasks. Supports accurate text rendering with multilingual capabilities, multiple aspect ratios including ultra-wide formats like 1:8 and 8:1, and output resolutions from 512px to 4K. Features real-time web search grounding to generate images based on current information like weather or recent events, and Google Image Search integration for finding web images as visual context.
- Model id
google/nano-banana-2- Provider
- Output
- Image
- Price
- From 24 credits per run, the same as on voor.ai. Options such as length or resolution can change it.
Request
POST https://voor.ai/v1/generations with "model": "google/nano-banana-2". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.
curl https://voor.ai/v1/generations \
-H "Authorization: Bearer $VOOR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/nano-banana-2",
"input": {
"prompt": "A red fox standing in fresh snow at golden hour, soft light"
},
"callback_url": "https://example.com/webhooks/voor"
}'
# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
-H "Authorization: Bearer $VOOR_API_KEY"Input parameters
| Name | Type | Details |
|---|---|---|
promptrequired | string | A text description of the image you want to generate |
reference_images | array of URLs | Input images to transform or use as reference (supports up to 14 images) Default: Up to 10 files · Accepts image/* |
aspect_ratio | string | Default: One of: match_input_image, 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 |
resolution | string | Default: One of: 1k, 2k, 4k |
output_format | string | Default: One of: jpg, png |
web_search | boolean | Use Google Web Search grounding to generate images based on real-time information (e.g. weather, sports scores, recent events). Default: |
image_search | boolean | Use Google Image Search grounding to find web images as visual context for generation. When enabled, web search is also used automatically. Default: |