Skip to main content
🔥 Latest Release: Google launched Nano Banana 2 (gemini-3.1-flash-image-preview) on February 26, 2026 — Pro-level quality at Flash-tier speed, pay-as-you-go as low as $0.025/image! View Nano Banana 2 Documentation
Nano Banana Pro (codename) is Google’s image generation model series, currently with the following available versions:

​
Latest Versions

  • Nano Banana 2: gemini-3.1-flash-image-preview (🔥 Launched February 26, 2026) — View Details
  • Nano Banana Pro: gemini-3-pro-image-preview (Launched November 20, 2025)

​
Previous Versions

  • Official Release: gemini-2.5-flash-image (Stable version, supports 10 aspect ratios)
  • Preview Version: gemini-2.5-flash-image-preview (⚠️ Discontinued on October 30, 2025)

📚 Latest Documentation

Feishu Complete Usage Guide - Fastest updates, supports comment interactionVisit Feishu documentation for latest tutorials, tips sharing, and Q&A. Documentation continuously updated, questions can be discussed directly in Feishu comments.

Core Advantages
  • 🔥 Nano Banana Pro New Features:
    • 🎯 4K High-Resolution Support: Supports 1K, 2K, 4K three resolutions, up to 4096×4096
    • 📝 Text Rendering King: Clear and readable text in images, perfect for posters and ads
    • ✨ Local Editing: Supports camera angle, focus, color grading, scene lighting adjustments
    • 🧠 Smart Reasoning: Based on Gemini 3 Pro, better understanding of complex prompts
  • 🚀 Universal Advantages:
    • ⚡ Generation Speed: Nano Banana Pro ~20 seconds, previous version ~10 seconds
    • 💰 Affordable Pricing: Combined with top-up bonuses, extremely cost-effective
    • 🔄 Full Compatibility: Fully compatible with Google official Gemini API format
    • 🎨 Google Technology: Based on Google’s latest and strongest image generation/editing technology

​
Interactive API Testing

Text-to-Image API

Enter a text prompt to generate images, with interactive Playground for online testing.

Image Editing API

Upload an image + edit instructions to generate edited images, with interactive Playground for online testing.

​
Calling Method

Use Google’s native Gemini API format: 
POST /v1beta/models/gemini-3-pro-image-preview:generateContent
  • ✅ Supports 4K high-resolution (1K / 2K / 4K)
  • ✅ 10 aspect ratios to choose from
  • ✅ Industry-best text rendering
  • ✅ Advanced local editing
  • 📖 Fully compatible with Google official API format, refer to ai.google.dev/gemini-api/docs/image-generation

​
Unsupported Features

The following Google official features are not supported via APIYI and require separate billing:
  • Grounding with Google Search: Real-time search info via tools: [{"google_search": {}}]
  • thinkingConfig (Thinking mode): Only supported on Nano Banana 2, not on Nano Banana Pro
  • Image Search Grounding: Nano Banana 2 exclusive feature
All other image generation and editing capabilities are fully supported.

​
Price Comparison

ModelPricingAdvantage
Nano Banana Pro (4K)$0.09/image (~¥0.52 with bonuses)🔥 4K support, ~38% of official price
Nano Banana Pro (1K-2K)$0.09/image (~¥0.52 with bonuses)🔥 High-res output, ~67% of official price
Nano Banana$0.025/image (~¥0.15 with bonuses)⭐ Fast generation, 52% of official price
gpt-image-1Higher-
flux-kontext-pro$0.035/imageOn par
Cost-effectiveness Recommendation:
  • Nano Banana Pro: 4K support, strongest text rendering, pricing at ~38-67% of official
  • NanoBananaEnterprise: Enterprise HA channel available at 1.4x rate ($0.126/image) for high-availability needs
  • Nano Banana: Fast generation (~10 seconds), 52% of official price, suitable for regular high-quality image generation

​
Compatibility Notes

If you’ve previously used the following models, simply replace the model name:

​
Upgrade to Latest Version

  • Any old version → gemini-3-pro-image-preview (🔥 Recommended, Nano Banana Pro)
    • Supports 4K high-resolution output
    • Strongest text rendering capabilities
    • Local editing features

​
Use Stable Version

  • gpt-4o-image → gemini-2.5-flash-image
  • sora_image → gemini-2.5-flash-image
  • Old Nano Banana → gemini-2.5-flash-image
Keep other parameters unchanged for seamless switching.

​
FAQ

For best value choose Nano Banana 2 (gemini-3.1-flash-image-preview):
  • Pro-level quality + Flash-tier speed
  • Pay-as-you-go as low as $0.025/image
  • 14 aspect ratios (4 more than Pro)
  • Exclusive: thinking mode, Image Search Grounding
For ultimate quality choose Nano Banana Pro (gemini-3-pro-image-preview):
  • Highest fidelity
  • $0.05/request
See Nano Banana 2 docs for details.
Recommended for new projects: Nano Banana Pro (gemini-3-pro-image-preview)✅ Pro Version Advantages:
  • Supports 4K ultra-high resolution (1K, 2K, 4K)
  • Industry-leading text rendering quality
  • Advanced local editing features
  • Only ~38-67% of official pricing
⚡ Legacy Version (gemini-2.5-flash-image) suitable for:
  • Budget-sensitive scenarios (~$0.025/image vs $0.09/image)
  • Need fast generation (10s vs 20s)
  • Existing project migration
Simply change the model name from gpt-4o-image or sora_image to gemini-3-pro-image-preview (recommended Pro) or gemini-2.5-flash-image (legacy), keeping other parameters unchanged.
The model returns base64-encoded image data, typically in PNG or JPEG format. Code automatically detects format and saves to corresponding file type.
Yes, Nano Banana Pro supports both image generation and editing. See Image Editing API Reference.