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

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

Editing

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