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
google
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

NameTypeDetails
promptrequiredstring

A text description of the image you want to generate

reference_imagesarray of URLs

Input images to transform or use as reference (supports up to 14 images)

Default: []

Up to 10 files · Accepts image/*

aspect_ratiostring

Default: match_input_image

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

resolutionstring

Default: 1k

One of: 1k, 2k, 4k

output_formatstring

Default: jpg

One of: jpg, png

web_searchboolean

Use Google Web Search grounding to generate images based on real-time information (e.g. weather, sports scores, recent events).

Default: false

image_searchboolean

Use Google Image Search grounding to find web images as visual context for generation. When enabled, web search is also used automatically.

Default: false