Nano Banana API · Ace Data Cloud

Nano Banana API：
Generate AI Images

Based on Google Gemini 2.5 Flash/3 Pro Image model, it achieves high-quality image generation and editing through a simple REST API. Supports various scenarios such as text-to-image, multi-image editing, virtual dressing, and product background change.

📄 View Documentation

🖼️ 2 Operation Modes 🤖 2 Model Versions 📐 7 Aspect Ratios 🔑 Bearer Token Authentication

🖼️

Operation Modes

🤖

Model Versions

📡

API Interfaces

📐

Aspect Ratio Options

What is Nano Banana?

Nano Banana is a unified API wrapper based on the Google Gemini image generation model. It simplifies and optimizes the Gemini 2.5 Flash Image and Gemini 3 Pro Image models, providing a more user-friendly interface and lower prices.

Ace Data Cloud offerslower prices than the official (about 1/3 of the official price), while providinghigher concurrency support, dedicated customer service, and 7×24 hours of stability guarantee. No need to deal with the complex configuration of Google Cloud, ready to use immediately.

Core Capabilities of Nano Banana API

Text-to-image and multi-image editing, covering the complete workflow of image creation

✨

High-Quality Text-to-Image

Input detailed text descriptions (subject, atmosphere, lighting, lens) to generate professional-grade high-quality images. Suitable for brand visuals, product posters, cover images, and more.

🔀

Multi-Image Collaborative Editing

Upload multiple images (e.g., portrait + clothing), and the AI will intelligently merge them. Supports advanced editing operations such as virtual try-ons, product placements, and scene compositions.

👗

Virtual Dressing

Provide portrait photos and clothing PNGs to automatically complete the outfit effect. Very suitable for e-commerce clothing displays and quick expansion of live stream images.

🏠

Product Scene Replacement

Place white-background product images into real scenes (wooden table, grass, bathroom, office desk) to make detail pages richer and more lively.

🎨

Attribute Replacement

Change materials, colors, styles. Change bags to leather, drinks to different flavors, shoes to different color schemes—making visual SKU experimentation easier.

⚡

Asynchronous Webhook

Set callback_url to automatically push results after task completion. No polling required, suitable for batch production scenarios.

AI Generated Work Showcase

The following images are all generated by the Nano Banana API—what you see is what you get

White porcelain coffee cup, morning light windowsill

Morning Light Coffee Cup

nano-banana · 3:2 · Text-to-Image

Cyber City Skyline

nano-banana · 16:9 · Text-to-Image

Luxury Product Photography

nano-banana-pro · 1:1 · Text-to-Image

Golden Retriever Puppy in the Sun

nano-banana · 3:4 · Text-to-Image

💡 All images are generated through a single API call, without any post-processing

cURL

curl -X POST https://api.acedata.cloud/nano-banana/images \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "generate",
    "prompt": "White porcelain coffee cup, morning light on the windowsill, 85mm lens, shallow depth of field, soft highlights, healing and clean",
    "model": "nano-banana",
    "aspect_ratio": "3:2"
  }'

Response

{
  "success": true,
  "task_id": "c1075552-a527-4a70-8d98-ef783f4087c1",
  "trace_id": "3352b744-d17e-4d01-b1ef-a8c8e2ca3d2e",
  "data": [{
    "image_url": "https://cdn.acedata.cloud/d635720766.png"
  }]
}

Quick Start - Get Started in 3 Minutes

Simplified REST API, using Bearer Token authentication. A single request can generate your first AI image.

Get API Key

Send POST Request

Send a request to /nano-banana/images with the prompt and parameters

Get Image URL

Receive a permanently accessible image URL - ready for production use

Applicable Scenarios

From e-commerce content to brand creativity - Nano Banana can cover these scenarios

👗

E-commerce Clothing

Influencers take a fixed photo once, and then use different clothing PNGs to batch generate "outfit images," quickly expanding store materials

📦

Product Detail Page

A white background product image, composited with multiple scene images like wooden table/grass/bathroom, making the detail page richer and more persuasive

🎨

Brand Visuals

Quickly generate brand KV, event posters, cover images. Switch styles/holiday themes for the same main visual with one click

🤖

AI Agent Integration

Integrate with Claude and ChatGPT through MCP Server or Dify plugin for natural language image generation

Advanced Features

Nano Banana is not just a simple text-to-image tool; it can also accomplish these advanced tasks

🎭

2D to 3D Figurine

Convert anime characters/portraits into commercial figurine models, displayed with packaging boxes

🔧

Product Exploded View

Show the internal structure of the product, with metal parts and electronic components decomposed and suspended, technical aesthetics

📷

Old Photo Restoration

Restore scratched and damaged black-and-white old photos, enhance clarity and colorize naturally

🚗

Diverse Group Image

Naturally blend multiple materials such as models, products, and backgrounds into a high-quality image

+ Multi-angle Shots + Emoji Generation + Sketch to Real Image + Map to Real Scene

3 Steps to Get Started Quickly

From registration to generating your first AI image, it takes less than 3 minutes

Register and Get API Key

Create a free account on Ace Data Cloud. Generate your Bearer Token from the API management console.

Initiate Your First API Call

Send a POST request with a text prompt to /nano-banana/images. You can use SDK, cURL, or any HTTP client.

Integration and Expansion

Embed the API into your application. Use Webhook for asynchronous processing, confidently expand to production environments.

View Documentation →

Why Choose Ace Data Cloud?

Compare with Google Official and see our advantages

Feature	Ace Data Cloud	Google Official
Price	As low as $0.0133 / time	$0.039 Interactive / $0.02 Batch
Activation Threshold	✓ Ready to use	✗ Requires Google Cloud configuration
Concurrent Support	✓ High concurrency guarantee	✗ Default quota is low
Webhook Callback	✓	Partial support
Task Polling	✓ Free	—
MCP Server	✓	✗
Dify Plugin	✓	✗
Dedicated Customer Service	✓	✗
7×24 Monitoring	✓	Partial support

Which model is right for you?

Choose the right model based on your needs for quality and speed

Recommended

nano-banana

Fast

Based on Gemini 2.5 Flash Image. Faster generation speed, lower cost, suitable for bulk content production and prototype validation.

✓ Faster response time
✓ As low as $0.0133 / call
✓ 7 aspect ratios
✓ Suitable for high-frequency scenarios

nano-banana-2-lite

Lightweight

Based on Gemini 3.1 Flash Lite Image. Supports only 1K resolution, 3-5 seconds fast output.

✓ Gemini 3.1 lightweight model
✓ As low as $0.0133 / call
✓ Supports only 1K resolution
✓ Suitable for quick validation

New

nano-banana-2

Balanced

Based on Gemini 3.1 Flash Image. Pro-level quality + Flash speed, cost-effective choice.

✓ Pro-level image quality
✓ Flash-level response speed
✓ As low as $0.0267 / call
✓ Suitable for most scenarios

nano-banana-pro

High Quality

Based on Gemini 3 Pro Image. Highest quality output, supports 2K/4K resolution. Suitable for flagship products and high-demand scenarios.

✓ Highest image quality
✓ As low as $0.0333 / call
✓ Supports 1K/2K/4K resolution
✓ Suitable for brand visuals

Nano Banana API Pricing

Transparent pay-as-you-go pricing. No subscription fees. No hidden costs. Pay only for what you use.

Pay-as-you-go

Standard

$0.0133 / call

nano-banana model (Gemini 2.5 Flash Image)
Up to 27% discount on bulk packages

✓ Generate
✓ Edit
✓ 7 aspect ratios
✓ Webhook callback
✓ Task polling——Free
✓ nano-banana-2-lite: as low as $0.0133 / call
✓ nano-banana-2: as low as $0.0267 / call
✓ nano-banana-pro: as low as $0.0333 / call

View Pricing Details View API Documentation

Enterprise

Custom

Bulk discounts for high-usage teams

✓ Usage-based discounts
✓ Priority support
✓ Dedicated account manager
✓ Custom rate limits
✓ SLA guarantee

Contact Sales

Frequently Asked Questions

Everything you need to know about using the Nano Banana API

What model is Nano Banana? ▾

Nano Banana is an alias wrapper for the Google Gemini image generation model. nano-banana corresponds to Gemini 2.5 Flash Image, nano-banana-2-lite corresponds to Gemini 3.1 Flash Lite Image (only 1K, fast image generation), nano-banana-2 corresponds to Gemini 3.1 Flash Image (Pro level quality + Flash speed), and nano-banana-pro corresponds to Gemini 3 Pro Image. We provide a more streamlined interface and lower prices.

What is the pricing model? ▾

Pay-as-you-go, no subscription fees. The nano-banana and nano-banana-2-lite models start at $0.0133 per use, the nano-banana-2 model starts at $0.0267 per use, and the nano-banana-pro model starts at $0.0333 per use. Task status polling is free forever. Bulk packages can enjoy up to a 27% discount.

What image operations are supported? ▾

Two operation modes: Generate (text to image) and Edit (multi-image editing). Generate supports 7 aspect ratios (1:1, 3:2, 2:3, 16:9, 9:16, 4:3, 3:4), and the Pro model also supports 1K/2K/4K resolution options. The Edit mode supports uploading up to 10 images for joint editing.

How to handle longer generation times? ▾

Two methods: (1) Use callback_url—set the Webhook URL, and we will POST the results upon completion. (2) Poll through /nano-banana/tasks—this interface is free and allows you to check the status at any time.

Are image URLs permanently valid? ▾

Yes. The returned image_url is stored on our CDN, accessible permanently, and can be used directly in production environments.

Can it be used with Claude or ChatGPT? ▾

Yes! We provide the MCP Server (mcp-nano-banana) and Dify plugin, which can be directly integrated with Claude Desktop, VS Code, and Dify workflows. Your AI Agent can generate and edit images through natural language.

How to write a good prompt? ▾

Recommended structure: Subject + Atmosphere + Lighting + Lens + Texture keywords. For example: "White porcelain coffee cup, morning light on the windowsill, 85mm portrait lens, shallow depth of field, soft highlights, healing, clean, leisurely". The more specific the description, the better the generation effect.

What should be noted in Edit mode? ▾

Edit mode requires passing in 1-10 images through the image_urls parameter (HTTP/HTTPS URL or Base64). Each image can be a maximum of 10MB. The prompt needs to describe how to handle these images, for example, "Make this person wear this T-shirt".

Other AI Models

Explore our complete AI API suite, covering fields such as images, videos, music, and more

🌌

Seedream API

ByteDance high-definition text-to-image model

→

✨

Flux API

Fast AI image generation, supporting various styles and models

→

🎬

Luma API

Create AI-generated videos using Dream Machine and Ray models

→

🎵

Suno API

AI music generation—generate complete songs, covers, and instrumental music

→

Start generating AI images now

As low as $0.0133 per call—lower prices than the official, a simpler interface, and higher concurrency support. Pay as you go—no subscription fees, no commitments.

📄 View Documentation →

Nano Banana API： Generate AI Images

nano-banana

Playground

Input

Result

API

Pricing

Packages

Route pricing

Request calculator

Overview

nano-banana

Model facts