Nano Banana API · Ace Data Cloud

Nano Banana API：
Generate AI Images

Name: Nano Banana Image Generation
Brand: Ace Data Cloud

Based on Google Gemini 2.5 Flash/3 Pro Image models, enabling high-quality image generation and editing through a simple REST API. Supports multiple scenarios including text-to-image, multi-image editing, virtual try-on, and product background replacement.

📄 View Documentation

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

🖼️

Operation Modes

🤖

Model Versions

📡

API Endpoints

📐

Aspect Ratio Options

What Is Nano Banana?

Nano Banana is a unified API wrapper based on Google Gemini image generation models. 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 offers lower prices than the official service (approximately one-third of the official price), along with higher concurrency support, dedicated customer service, and 24/7 stability assurance. No need to handle Google Cloud's complex configuration—ready to use out of the box.

Core Capabilities of the Nano Banana API

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

✨

High-Quality Text-to-Image

Enter a detailed text description (subject, mood, lighting, camera), and generate professional-grade, high-quality images. Ideal for brand visuals, product posters, cover images, and more.

🔀

Multi-Image Combined Editing

Upload multiple images (such as a portrait + clothing), and AI will intelligently blend them. Supports advanced editing operations such as virtual try-on, product placement, and scene composition.

👗

Virtual Outfit Change

Provide a portrait photo and a clothing PNG to automatically create the outfit result. Perfect for e-commerce apparel displays and quickly expanding livestream images.

🏠

Product Scene Replacement

Place white-background product images into realistic scenes (wooden tables, grass, bathrooms, desks) to make product detail pages richer and more lifelike.

🎨

Attribute Replacement

Change materials, colors, and styles. Swap a bag to leather, a beverage to another flavor, or shoes to a new colorway—making visual SKU experimentation easier.

⚡

Asynchronous Webhook

Set callback_url, and results are automatically pushed when the task is complete. No polling required, ideal for batch production scenarios.

AI-Generated Work Showcase

The images below were all generated by the Nano Banana API—what you see is what you get

White porcelain coffee cup, morning windowsill

Morning 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 were generated with 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": "白瓷咖啡杯，晨光窗台，85mm镜头，浅景深，柔和高光，治愈干净",
    "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 — Up and Running in 3 Minutes

A simple REST API using Bearer Token authentication. Generate your first AI image with a single request.

Get an API Key

Send a POST Request

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

Get the Image URL

Receive a permanently accessible image URL—ready for production use immediately

Use Cases

From e-commerce content to brand creativity—Nano Banana covers these scenarios

👗

E-commerce Apparel

Have an influencer take a single styled photo, then use different clothing PNGs to batch-generate outfit images and quickly expand your store assets

📦

Product Detail Pages

Turn a single product image on a white background into images set on wooden tables, grass, bathrooms, and more, making detail pages richer and more persuasive

🎨

Brand Visuals

Quickly generate brand key visuals, campaign posters, and cover images. Switch the style or holiday theme of the same key visual with one click

🤖

AI Agent Integration

Integrate with MCP-compatible AI assistants through the MCP Server for natural-language image generation

Advanced Features

Nano Banana is more than simple text-to-image generation—it can also handle these advanced tasks

🎭

2D to 3D Figurines

Convert anime characters/portraits into commercial figurine models, complete with packaging box displays

🔧

Product Exploded Views

Showcase internal product structures, with metal parts and electronic components exploded and floating for technical aesthetics

📷

Old Photo Restoration

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

🚗

Multi-Element Composites

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

+ Multi-angle shots + Meme generation + Sketch-to-realistic images + Map-to-real-world scenes

Get Started in 3 Quick Steps

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

Register and Get an API Key

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

Make Your First API Call

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

Integrate and Scale

Embed the API into your application. Use Webhooks for asynchronous processing and confidently scale to production.

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 / request	$0.039 Interactive / $0.02 Batch
Setup requirements	✓ Ready to use instantly	✗ Google Cloud configuration required
Concurrency support	✓ High-concurrency guarantee	✗ Low default quota
Webhook callbacks	✓	Partially supported
Task polling	✓ Free	—
MCP Server	✓	✗
Dedicated customer support	✓	✗
24/7 monitoring	✓	Partially supported

Which model is right for you?

Choose the right model based on your quality and speed requirements

Recommended

nano-banana

Fast

Based on Gemini 2.5 Flash Image. Faster generation speeds and lower costs, ideal for batch content production and prototype validation.

✓ Faster response speed
✓ As low as $0.0133 / request
✓ 7 aspect ratios
✓ Ideal for high-frequency use cases

nano-banana-2-lite

Lightweight

Based on Gemini 3.1 Flash Lite Image. Supports 1K resolution only, with images generated in 3–5 seconds.

✓ Gemini 3.1 lightweight model
✓ As low as $0.0133 / request
✓ Supports 1K resolution only
✓ Ideal for rapid validation

New

nano-banana-2

Balanced

Based on Gemini 3.1 Flash Image. Pro-level quality + Flash speed, an excellent value choice.

✓ Pro-level image quality
✓ Flash-level response speed
✓ As low as $0.0267 / request
✓ Ideal for most use cases

nano-banana-pro

High Quality

Based on Gemini 3 Pro Image. Highest-quality output with support for 2K/4K resolutions. Ideal for flagship products and demanding use cases.

✓ Highest image quality
✓ As low as $0.0333 / request
✓ Supports 1K/2K/4K resolutions
✓ Ideal 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)
Save up to 27% with bulk packages

✓ Text-to-image (Generate)
✓ Multi-image editing (Edit)
✓ 7 aspect ratios
✓ Webhook callbacks
✓ 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

Volume 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 Google Gemini image generation models. nano-banana corresponds to Gemini 2.5 Flash Image, nano-banana-2-lite corresponds to Gemini 3.1 Flash Lite Image (1K only, 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 simpler API and lower prices.

How does pricing work? ▾

Pay as you go, with no subscription fee. nano-banana and nano-banana-2-lite models start at $0.0133 per request, nano-banana-2 models start at $0.0267 per request, and nano-banana-pro models start at $0.0333 per request. Task status polling is always free. Bulk packages offer up to 27% off.

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 Pro models also support 1K/2K/4K resolution options. Edit mode supports uploading up to 10 images for joint editing.

How do I handle longer generation times? ▾

Two options: (1) Use callback_url—set a Webhook URL, and we will POST the result when it is complete. (2) Poll via /nano-banana/tasks—this API is free and lets you check the status at any time.

Are image URLs permanently valid? ▾

Yes. The returned image_url is stored on our CDN and remains permanently accessible, ready for direct use in production.

Can it be used with Claude or ChatGPT? ▾

Yes! We provide an MCP Server (mcp-nano-banana) that can integrate with AI assistants supporting MCP. Your AI Agent can generate and edit images through natural language.

How do I write good prompts? ▾

Recommended structure: subject + mood + lighting + lens + texture keywords. For example: "White porcelain coffee cup, morning-light windowsill, 85mm portrait lens, shallow depth of field, soft highlights, soothing, clean, leisurely." The more specific your description, the better the generated result.

What should I keep in mind for Edit mode? ▾

Edit mode requires passing 1-10 images through the image_urls parameter (HTTP/HTTPS URL or Base64). Each image can be up to 10MB. The prompt should describe how to process these images, for example, "Have this person wear this T-shirt."

Other AI Models

Explore our complete AI API suite, covering images, video, music, and more

🌌

Seedream API

ByteDance high-definition text-to-image model

→

✨

Flux API

Fast AI image generation with support for multiple styles and models

→

🎬

Luma API

Create AI-generated videos using Dream Machine and Ray models

→

🎵

Suno API

AI music generation—create full songs, covers, and instrumental music

→

Start Generating AI Images Now

Starting at $0.0133 per call—lower prices than the official service, a simpler interface, and higher concurrency support. Pay as you go—no subscription fees, no commitment.

📄 View Documentation →

Packages

We offer various credit packages. The more you purchase, the higher the discount you receive.

up to46% OFF

Price
Nano Banana Images API
Nano Banana Tasks API

NanoBanana MCP

Generate and edit images using Nano Banana in the AI Agent through MCP.

Agent app

Installation Scope

Operating System

Configuration Method

Connect the current service in Claude Code:

Current project: Merge the mcpServers service entry below into .mcp.json in the project root directory, retaining the existing configuration.
Current user: Run the command below in the terminal; the configuration can be reused across projects.
Project configuration requires setting ACEDATACLOUD_API_TOKEN in the terminal: use export ACEDATACLOUD_API_TOKEN='YOUR_API_TOKEN' on macOS/Linux, and $env:ACEDATACLOUD_API_TOKEN = 'YOUR_API_TOKEN' in Windows PowerShell; replace YOUR_API_TOKEN with your AceDataCloud API Token.
Run claude in the same terminal where this variable has been set; new terminals or desktop-launched clients must also be able to read this variable.
After entering the Claude Code session, run /mcp to confirm that the service is connected and the tools have been loaded; when using the project configuration for the first time, check and approve the service as prompted.

export ACEDATACLOUD_API_TOKEN='YOUR_API_TOKEN'
claude mcp add --scope user --transport http 'nanobanana-mcp' 'https://nanobanana.mcp.acedata.cloud/mcp' --header 'Authorization: Bearer ${ACEDATACLOUD_API_TOKEN}'

View source code

Nano Banana Image

Provide prompt words, reference images, and result processing guidelines for AI Agent's Nano Banana image generation and editing.

Agent app

Installation Scope

Install the current Skill to Claude Code. Project-level configurations are shared across the repository, while user-level configurations apply to all projects on this machine.

npx skills add acedatacloud/skills --skill 'nano-banana-image' -a 'claude-code' --yes

View source code