Overview
Nano Banana Image Edit is based on Google’s Gemini image generation model series, currently with the following available versions:Latest Version (Recommended)
- Nano Banana Pro:
gemini-3-pro-image-preview(🔥 Launched November 20, 2025)- Based on Gemini 3 Pro, stronger reasoning capabilities
- Supports 4K high-resolution image editing (1K, 2K, 4K)
- Advanced local editing: camera angles, focus, color grading, scene lighting
- Industry-leading text rendering capabilities
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)
🔥 November 20, 2025 Major Update: Google released Nano Banana Pro (
gemini-3-pro-image-preview)! Brand new image editing model based on Gemini 3 Pro, supports 4K high-resolution editing, advanced local editing features (camera angles, focus, color, lighting), and industry-best text rendering capabilities.📚 Latest Documentation
Feishu Complete Usage Guide - Updated fastest, supports comment interactionVisit Feishu documentation for the latest usage tutorials, tips sharing, and Q&A. Documentation is continuously updated, and you can comment directly on Feishu for discussions.
Editing Features
-
🔥 Nano Banana Pro Exclusive Advanced Editing:
- 📐 Fine Local Editing: Adjust camera angles, change focus, apply color grading
- 🌓 Scene Lighting Control: Day-night conversion, bokeh effects, custom lighting
- 🎯 4K High-Res Editing: Supports up to 4K resolution image editing
- 📝 Perfect Text Rendering: Clear and readable text in edited images
-
🚀 Universal Editing Capabilities:
- 🖼️ Multi-Image Composition: Seamlessly merge multiple images into one
- ✏️ Text Instruction Editing: Describe editing needs through natural language
- 🔄 Smart Modification: Add, remove, or modify elements in images
- 🎨 Style Conversion: Change image style, color, artistic effects
- ⚡ Processing Speed: Nano Banana Pro ~20 seconds, previous version ~10 seconds
Editing Capabilities
Nano Banana Pro Exclusive Advanced Editing
-
📐 Fine Local Editing:
- Adjust camera angles (Camera Angles)
- Change focus and depth of field
- Apply professional-grade color grading (Color Grading)
-
🌓 Scene Lighting Control:
- Day-night conversion effects
- Background bokeh (Bokeh Effect)
- Custom lighting and shadows
-
🎯 4K High-Resolution Processing:
- Up to 4K resolution editing
- Maintain high-definition detail
- Professional-grade output quality
Universal Editing Capabilities
- Image Composition: Seamlessly merge multiple images into one
- Element Addition: Add new objects or elements to images
- Style Modification: Change artistic style or color tone of images
- Background Replacement: Replace image backgrounds
- Size Adjustment: Change image ratio or dimensions
- Detail Optimization: Enhance image quality or fix defects
- Text Addition/Editing: Nano Banana Pro has the strongest text rendering capabilities
API Usage
Basic Structure
Uses chat completion endpoint with multimodal input support (text + images):Request Format
Complete Python Example
Edit Scenario Examples
1. Multi-Image Composition
2. Background Replacement
3. Style Conversion
4. Element Modification
Best Practices
Editing Instruction Optimization
Clear and Specific
Use specific, explicit descriptions✅ “Change background to blue ocean scene”
❌ “Change background”
Step-by-Step Description
Break down complex edits into steps✅ “First remove background, then add forest scene, finally add sunlight effect”
Image Input Recommendations
- Format Support: PNG, JPEG, GIF, and other mainstream formats
- Resolution: Recommended not to exceed 4096x4096
- File Size: Single image recommended not to exceed 10MB
- URL Requirements: Ensure image URLs are publicly accessible
Editing Quality Optimization
- High-Quality Input: Use clear, high-resolution original images
- Reasonable Instructions: Avoid overly complex or contradictory editing requirements
- Multiple Iterations: Complex edits can be done in multiple steps
- Reference Examples: Refer to successful editing cases
Error Handling
Common Errors and Solutions
Image URL inaccessible
Image URL inaccessible
Cause: Image URL is inaccessible or requires authenticationSolution:
- Use publicly accessible image URLs
- Check if URL is correct
- Ensure image server allows external access
Edit result doesn't match expectations
Edit result doesn't match expectations
Cause: Edit instructions not clear enough or input image quality is lowSolution:
- Use more specific, explicit edit instructions
- Provide high-quality input images
- Break down complex edits into steps
API response has no image data
API response has no image data
Cause: Edit task failed or response format is abnormalSolution:
- Check if edit instructions are reasonable
- Confirm input images are valid
- View complete API response content
Pricing Information
Nano Banana Pro (gemini-3-pro-image-preview)
Per-request billing, unified pricing for all resolutions:
| Resolution | API易 Price | Official Price | % of Official | With Top-up Bonuses | Generation Time | Recommended Scenarios |
|---|---|---|---|---|---|---|
| 1K-2K | $0.050/image | $0.134/image | 30% | ¥0.29/image | 20-25s | High-res web/social media |
| 4K | $0.050/image | $0.24/image | 17% | ¥0.29/image | 30-40s | Professional printing/commercial design |
Exceptional Value:
- 4K resolution at only 17% of official price, save 83%
- 1K-2K resolution at 30% of official price, save 70%
- With top-up bonuses ~¥0.29/image, extremely cost-effective
- 🎯 Supports 4K ultra-high-resolution output
- 📐 Fine local editing capabilities (camera, focus, color)
- 🌓 Scene lighting control
- 📝 Industry-best text rendering
Previous Version (gemini-2.5-flash-image)
- API易 Price: $0.025/image (1K resolution only)
- Official Price: Approximately $0.039/image
- Percentage of Official: 52%, save 48%
- With Top-up Bonuses: Approximately ¥0.15/image
- Generation Time: 10-15 seconds
- Recommended Scenarios: Quick editing, regular image processing
Cost Comparison Calculator
High-Res Editing Project
Requirement: 100 2K high-resolution image edits
- Nano Banana Pro (2K): ¥29
- Flash version (1K only): ¥15
4K Professional Project
Requirement: 50 4K professional image edits
- Nano Banana Pro (4K): ¥14.5 (Official needs ¥83.3)
- Flash version: Does not support 4K