# Nano Banana Image

> Nano Banana Image is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

- Skill name: `nano-banana-image`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/generation/nano-banana-image-acedatacloud-skills-2/SKILL.md
- Repository: majiayu000/claude-skill-registry (498 GitHub stars when collected)

## SKILL.md

# NanoBanana Image Generation

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

## Authentication

```bash
export ACEDATACLOUD_API_TOKEN="your-token-here"
```

## Quick Start

```bash
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

```json
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.

```json
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

```bash
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

---

Source: https://www.openparable.com/skill/documents/nano-banana-image (OpenParable). Cite the canonical URL above.