Skip to main content

Overview

Nano Banana 2 (codename) is Google’s latest image generation model released on February 26, 2026, with model ID gemini-3.1-flash-image-preview. It redefines image generation cost-effectiveness with Pro-level quality at Flash-tier speed and cost, making it the latest flagship of the Nano Banana series.
🔥 Released February 26, 2026: Nano Banana 2 is live! Pro-level quality, Flash-tier speed, 40% cheaper than Nano Banana Pro! Supports 4K output, 14 aspect ratios, Image Search Grounding, and more exclusive features.

Core Features

Pro-Level Quality

Vibrant lighting, rich textures, sharp details - quality rivaling Nano Banana Pro at much faster speeds

4K Ultra-HD Output

Supports 512px, 1K, 2K, 4K resolutions, up to 4096×4096

14 Aspect Ratios

New additions: 1:4, 4:1, 1:8, 8:1 - total 14 aspect ratios covering more use cases

Image Search Grounding

Nano Banana 2 exclusive - pulls visual context from Google Image Search

Accurate Text Rendering

Clear, legible text in images with multilingual support - perfect for posters and marketing materials

Multi-turn Editing

Conversational image editing with iterative refinement through chat

Thinking Mode

Configurable minimal or high thinking levels for more precise complex prompt handling

Subject Consistency

Maintains resemblance across up to 5 characters and 14 reference objects

Version Comparison

FeatureNano Banana 2Nano Banana ProNano Banana
Model IDgemini-3.1-flash-image-previewgemini-3-pro-image-previewgemini-2.5-flash-image
Quality⭐⭐⭐⭐⭐ Pro-level⭐⭐⭐⭐⭐ Highest⭐⭐⭐⭐ Excellent
Speed🚀 Fastest🐢 Slower⚡ Fast
Max Resolution4K4K2K
Aspect Ratios141010
Image Search Grounding✅ Exclusive
APIyi Pricing$0.03/image$0.05/image$0.025/image
StatusPreviewPreviewGA
Selection Guide:
  • 🔥 Best Value → Nano Banana 2 ($0.03/image, Pro-level quality + Flash-tier speed)
  • 🎨 Ultimate Quality → Nano Banana Pro ($0.05/image, highest fidelity)
  • Lowest Cost → Nano Banana ($0.025/image, fast and stable)

Pricing

ModelAPIyi PricingGoogle Official 4KDiscount
Nano Banana 2 gemini-3.1-flash-image-preview$0.03/image$0.151/image🔥 ~80% off
Nano Banana Pro gemini-3-pro-image-preview$0.05/image$0.151/image~67% off
Nano Banana gemini-2.5-flash-image$0.025/image$0.039/image (1K only)~36% off
Nano Banana (gemini-2.5-flash-image) supports up to 2K resolution only — no 4K option. The price shown is its 1K official pricing.
💰 4K HD for just $0.03! Google’s official 4K pricing is $0.151/image, APIyi offers it at only $0.03/image — ~80% off official! 40% cheaper than Nano Banana Pro, making it the best value 4K image generation solution. Combined with top-up bonuses, actual costs are even lower.

Supported Resolutions & Aspect Ratios

Output Resolutions

ResolutionDescriptionRecommended Use
512pxLow resolutionThumbnails, quick previews
1KDefaultSocial media, web display
2KHigh definitionHD displays, print materials
4KUltra-high definitionProfessional design, commercial posters

Supported Aspect Ratios (14 total)

1:1, 1:4, 4:1, 1:8, 8:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
Compared to Nano Banana Pro’s 10 aspect ratios, Nano Banana 2 adds 1:4, 4:1, 1:8, 8:1 - ultra-tall/ultra-wide ratios ideal for long-form images and infographics.

Calling Method

Google Native Format

  • Endpoint: /v1beta/models/gemini-3.1-flash-image-preview:generateContent
  • ✅ Custom resolutions (512px/1K/2K/4K)
  • ✅ 14 aspect ratios
  • 📖 Google official API format

Quick Start

Endpoint

POST https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent

Basic Generation Example

import requests
import base64

API_KEY = "sk-your-api-key"
PROMPT = "A cute Shiba Inu sitting under cherry blossom trees, watercolor style, HD details"

response = requests.post(
    "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
    headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
    json={
        "contents": [{"parts": [{"text": PROMPT}]}],
        "generationConfig": {
            "responseModalities": ["IMAGE"],
            "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
        }
    },
    timeout=300
).json()

img_data = response["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("output.png", 'wb') as f:
    f.write(base64.b64decode(img_data))
print("Image saved to output.png")

Image Editing Example

Nano Banana 2 supports multi-turn conversational image editing:
import requests
import base64

API_KEY = "sk-your-api-key"

# Read the image to edit
with open("input.jpg", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
    headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
    json={
        "contents": [{
            "parts": [
                {"text": "Please blur the background to highlight the person in the foreground"},
                {"inlineData": {"mimeType": "image/jpeg", "data": image_b64}}
            ]
        }],
        "generationConfig": {
            "responseModalities": ["IMAGE"],
            "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
        }
    },
    timeout=300
).json()

img_data = response["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("edited.png", 'wb') as f:
    f.write(base64.b64decode(img_data))

Request Parameters

Parameter Reference

ParameterTypeRequiredDescription
contentsarrayYesContent array containing text and/or inlineData
generationConfig.responseModalitiesarrayYesResponse type: ["IMAGE"] or ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatiostringNoAspect ratio, default 1:1
generationConfig.imageConfig.imageSizestringNoResolution: 512px / 1K / 2K / 4K, default 1K

Response Format

Response Example

{
  "candidates": [{
    "content": {
      "parts": [{
        "inlineData": {
          "mimeType": "image/png",
          "data": "iVBORw0KGgoAAAANSUhEUg..."
        }
      }]
    },
    "finishReason": "STOP"
  }],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 258
  }
}

FAQ

Nano Banana 2 (gemini-3.1-flash-image-preview) is based on Gemini 3.1 Flash, while Nano Banana Pro (gemini-3-pro-image-preview) is based on Gemini 3 Pro. Key differences:
  • Speed: Nano Banana 2 is faster (Flash-tier speed)
  • Price: Nano Banana 2 is cheaper ($0.03 vs $0.05)
  • Aspect Ratios: Nano Banana 2 supports 14 (4 more)
  • Image Search Grounding: Nano Banana 2 exclusive
  • ⚠️ Ultimate Quality: Nano Banana Pro still slightly better
Recommended! Nano Banana 2 offers near-Pro-level quality at a lower price with faster speed. Unless you have extreme quality requirements, Nano Banana 2 is the better choice.Simply change the model name from gemini-3-pro-image-preview to gemini-3.1-flash-image-preview.
Image Search Grounding is a Nano Banana 2 exclusive feature. It pulls visual context from Google Image Search to generate images that better match real-world subjects. For example, when generating images of real landmarks, it can reference search results for improved accuracy.
Thinking Mode allows the model to reason and analyze before generating images, improving accuracy for complex prompts. Setting it to high produces the best results but slightly increases generation time. Best for tasks requiring precise composition, text rendering, or complex scenes.
Generation time depends on resolution and thinking mode:
  • 1K resolution: ~5-10 seconds
  • 2K resolution: ~10-15 seconds
  • 4K resolution: ~15-25 seconds
  • Enabling high thinking mode adds a few extra seconds
Recommend setting a longer timeout (at least 120 seconds) for occasional delays.
Supports image/png and image/jpeg formats. Can be uploaded via base64 encoding or Files API.
All output images carry SynthID invisible digital watermarks (Google’s AI-generated content identification technology) - invisible to the naked eye and doesn’t affect usage.
Nano Banana 2 is currently in Preview status. Features and pricing may be adjusted. Please follow documentation updates for the latest information.