Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt

Use this file to discover all available pages before exploring further.

🔥 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.

​
Why APIYI’s Nano Banana Pro?

Nano Banana Pro / 2 is the #1 model by usage volume on APIYI — stable, reliable, and fast. If you want to work with a professional team, APIYI is the right choice. Google’s flagship with strict content-safety controls, optimized by APIYI across reliability, cost, and integration:

Official Channel · Same as Gemini

100% compatible with Google’s native Gemini API (/v1beta/models/.../generateContent) and the OpenAI SDK pattern — same request body, response fields, and error codes. Zero-code migration.

No Concurrency Limits

Not bound by Google AI Studio’s RPM/RPD ceilings. Enterprise-scale batch generation and peak traffic scale linearly without quota interruptions.

31-38% of Google's List Price

$0.09/image per-call (vs Google 4K $0.24). Stack with top-up bonuses for as low as 31.25% of list — 4K savings up to 68.75%.

Global Zero-Barrier Access

No overseas server or proxy required — connect directly to api.apiyi.com from mainland data centers, residential networks, or overseas nodes. Stable latency, no cross-border re-architecture.

Full Model Lineup

Same series covers Nano Banana 2 (best value + Flash speed), Nano Banana Pro (ultimate quality), and the legacy Nano Banana — mix and match per scenario.

Professional Enterprise Support

Our team specializes in production image-generation deployments, with deep experience in model selection, tuning, and integration — end-to-end support from PoC to production.

​
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

​
Group Setup

Nano Banana Pro ships with two groups on APIYI. Switch in dashboard → Token Settings:
GroupRateWhen to use
Default1.0xBase lane, per-call $0.09/image; recommended default
NanoBananaEnterprise1.4xFallback lane, per-call $0.126/image — manually switch when the default is tight or timeouts spike, capacity-prioritized
Why 1.4x? Even at 1.4x, the price is still around 50% of Google’s list — far below official pricing. This is a fallback lane for higher-concurrency workloads and unexpected upstream risk-control events, providing high-availability guarantees for enterprise customers. When the default group is tight, switch your Token to NanoBananaEnterprise to ride out the spike. Recommended Billing model: pick Pay-as-you-go Priority — covers Nano Banana Pro’s per-call billing AND Nano Banana 2’s token-based billing, one Token for the whole series.
Token creation UI: Billing model 'Pay-as-you-go Priority' covers NB Pro per-call + NB2 token-based; primary group Default + fallback group NanoBananaEnterprise (1.4x lane)
Going further: if your Token also covers other image models (e.g. GPT-image-2), keep the more stable Default as the primary group and put NanoBananaEnterprise in the fallback slot — 429s on the primary will auto-failover to the enterprise group without a token swap.

​
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.09/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.