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-proproduces 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