Nano Banana Image

Generate and edit AI images with NanoBanana (Gemini-based) via AceDataCloud API. Use when creating images from text prompts or editing existing images with text instructions. Supports nano-banana and nano-banana-pro models.

NanoBanana Image Generation

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

Authentication

export ACEDATACLOUD_API_TOKEN="your-token-here"

Quick Start

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

Models

Model	Best For
nano-banana	Standard image generation (default)
nano-banana-pro	Higher quality, more detailed output

Workflows

1. Text-to-Image

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

2. Image Editing

Edit an existing image using natural language instructions — no mask needed.

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

Parameters

Generation

Parameter	Values	Description
model	"nano-banana", "nano-banana-pro"	Model to use
aspect_ratio	"1:1", "3:4", "4:3", "9:16", "16:9"	Output aspect ratio

Editing

Parameter	Required	Description
image_url	Yes	URL of the source image
prompt	Yes	Natural language editing instruction
model	No	Model to use (defaults to "nano-banana")
aspect_ratio	No	Output aspect ratio

MCP Server

pip install mcp-nano-banana

Or hosted: https://nano-banana.mcp.acedata.cloud/mcp

Key tools: nano_banana_generate_image, nano_banana_edit_image

Gotchas

• Editing does NOT require a mask — just describe the change in natural language
• nano-banana-pro produces significantly more detailed results but costs more
• Results return a direct image URL — no task polling needed
• Aspect ratio uses colon notation (e.g., "16:9") not pixel dimensions
• The Gemini-based model excels at understanding complex, conversational editing instructions