Skip to content
Docs menu

Image models

Nano Banana

On this page

Google's Nano Banana (Gemini 2.5 Flash Image) — fast, high-fidelity image generation and editing.

modelIdgoogle-nano-banana, google-nano-banana-edit
Modalityimage
PricingSee this model on the Pricing page for the current per-call price (with your markup).

Operations

OperationmodelIdEndpointRequired input
Nano Bananagoogle-nano-bananaPOST /api/v1/generateprompt
Nano Banana Editgoogle-nano-banana-editPOST /api/v1/generateprompt, image_urls
Poll taskGET /api/v1/task/{id}?model=google-nano-banana

Nano Banana — google-nano-banana

FieldTypeRequiredValues / example
promptstringYesThe prompt for image generation Max 20000 characters. (example: Minimal line-art poster of a whale formed from ocean waves, single-weight ink on warm off-white paper.)
output_formatstringNoOutput format for the images (options: png | jpeg) (default: png)
aspect_ratiostringNoRadio description (options: 1:1 | 9:16 | 16:9 | 3:4 | 4:3 | 3:2 | 2:3 | 5:4 | 4:5 | 21:9 | auto) (default: 1:1)
nsfw_checkerbooleanNoA configurable parameter. Defaults to true in the Playground. (true/false) (default: true)
bash
curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"google-nano-banana","input":{"prompt":"Minimal line-art poster of a whale formed from ocean waves, single-weight ink on warm off-white paper.","output_format":"png","aspect_ratio":"1:1","nsfw_checker":true}}'

Nano Banana Edit — google-nano-banana-edit

FieldTypeRequiredValues / example
promptstringYesThe prompt for image editing Max 20000 characters. (example: Create a 1:1 marketplace listing image from the uploaded photo. Keep the subject, its shape and its label text exactly as uploaded; replace only the background… — full value in the request example)
image_urlsstring[]YesList of URLs of input images for editing,up to 10 images. (image URL)
output_formatstringNoOutput format for the images (options: png | jpeg) (default: png)
aspect_ratiostringNoRadio description (options: 1:1 | 9:16 | 16:9 | 3:4 | 4:3 | 3:2 | 2:3 | 5:4 | 4:5 | 21:9 | auto) (default: 1:1)
nsfw_checkerbooleanNoA configurable parameter. Defaults to true in the Playground. (true/false) (default: true)
bash
curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"google-nano-banana-edit","input":{"prompt":"Create a 1:1 marketplace listing image from the uploaded photo. Keep the subject, its shape and its label text exactly as uploaded; replace only the background with a seamless warm-grey studio sweep. Even softbox light, one soft contact shadow under the subject, no colour cast. Straighten the subject, centre it with generous margins, and clean up dust and scuffs without smoothing real texture. Catalogue-ready commercial retouching. No added props, no watermark, no text, no people.","image_urls":["https://you.bot/examples/grok-imagine-text-to-image.jpg"],"output_format":"png","aspect_ratio":"1:1","nsfw_checker":true}}'