NanoBanana Image Generation

Generate and edit AI images through AceDataCloud's NanoBanana (Gemini-based) API.

Setup: See authentication for token setup.

Quick Start

curl -X POST https://api.acedata.cloud/nano-banana/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "a watercolor painting of a French countryside village", "model": "nano-banana"}'

Async: See async task polling. Poll via POST /nano-banana/tasks with {"id": "..."}.

Models

Model	Best For
`nano-banana`	Standard image generation (default)
`nano-banana-2-lite`	Fast, lightweight second-generation model
`nano-banana-2`	Improved quality, second generation
`nano-banana-pro`	Highest quality, most detailed output
`nano-banana:official`	Official channel variant of `nano-banana`
`nano-banana-2-lite:official`	Official channel variant of `nano-banana-2-lite`
`nano-banana-2:official`	Official channel variant of `nano-banana-2`
`nano-banana-pro:official`	Official channel variant of `nano-banana-pro`

Workflows

1. Text-to-Image

POST /nano-banana/images
{
  "action": "generate",
  "prompt": "a photorealistic macro shot of morning dew on a spider web",
  "model": "nano-banana-pro",
  "aspect_ratio": "16:9",
  "resolution": "2K"
}

2. Image Editing

Edit existing images using natural language instructions — no mask needed. Pass source images via image_urls.

POST /nano-banana/images
{
  "action": "edit",
  "prompt": "change the background to a starry night sky",
  "image_urls": ["https://example.com/photo.jpg"],
  "model": "nano-banana"
}

Parameters

Parameter	Values	Description
`action`	`"generate"`, `"edit"`	Operation mode
`model`	`"nano-banana"`, `"nano-banana-2-lite"`, `"nano-banana-2"`, `"nano-banana-pro"`, `"nano-banana:official"`, `"nano-banana-2-lite:official"`, `"nano-banana-2:official"`, `"nano-banana-pro:official"`	Model to use
`prompt`	string	Image description or editing instruction
`image_urls`	array of strings	Source image URLs (required for edit action)
`aspect_ratio`	`"1:1"`, `"3:2"`, `"2:3"`, `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"`	Output aspect ratio
`resolution`	`"1K"`, `"2K"`, `"4K"`	Output resolution (1K=1024px, 2K=2048px, 4K=4096px)
`callback_url`	string	Async callback URL; returns a task ID immediately

Gotchas

Editing does NOT require a mask — just describe the change in natural language
Editing uses the same /nano-banana/images endpoint with action: "edit" and image_urls array (not a separate /edit path)
nano-banana-2 is the second-generation model; nano-banana-pro offers the highest quality
:official variants (e.g., nano-banana:official) route through the official channel
Task polling uses id (not task_id) in the /nano-banana/tasks request body
Aspect ratio uses colon notation (e.g., "16:9") not pixel dimensions
The Gemini-based model excels at understanding complex, conversational editing instructions

MCP: pip install mcp-nano-banana | Hosted: https://nanobanana.mcp.acedata.cloud/mcp | See all MCP servers

nano-banana-image

NanoBanana Image Generation

Quick Start

Models

Workflows

1. Text-to-Image

2. Image Editing

Parameters

Gotchas