Nano Banana Pro API

Model-specific Buble API parameters, modes, pricing, and examples for Nano Banana Pro.

Nano Banana Pro API

Nano Banana Pro is the higher-quality image model for professional creative production, commercial visuals, and precise image transformation.

Model keys

  • google/nano-banana-pro — Nano Banana Pro

Supported modes and inputs

ModelModeLabelInput requirements
google/nano-banana-protext_to_imageText to ImagePrompt max 10000 chars
google/nano-banana-proimage_to_imageImage to ImagePrompt max 10000 chars
Images reference: 1-8 files, 30 MB, formats jpg, jpeg, png, webp

Options

ModelOptionDefaultAllowed valuesApplies to
google/nano-banana-proaspect_ratio1:11:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, autoAll modes
google/nano-banana-proresolution1K1K, 2K, 4KAll modes
google/nano-banana-prooutput_formatpngpng, jpgAll modes

Pricing

ModelPricing
google/nano-banana-pro2 credits per image

Production guidance

  • Pass mode explicitly.
  • Use only option values listed above.
  • Upload media with POST /api/v1/files before calling media-input modes.
  • Use the exact model key for the variant you want.

Example: text to image

curl https://buble.ai/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-pro",
    "mode": "text_to_image",
    "prompt": "A premium editorial product image of a minimalist ceramic coffee grinder on a warm walnut counter, soft studio lighting",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }'

Example: image to image

Upload an image first, then pass the returned URL to image_urls.

curl https://buble.ai/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-pro",
    "mode": "image_to_image",
    "prompt": "Transform the source into a clean commercial product image while preserving the main object",
    "image_urls": ["https://example.com/source.png"],
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }'