Skip to the rows

agentsclimarketplace

Nano banana image

Skill AceDataCloud/Skills/skills/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, nano-banana-2, nano-banana-pro and their :official variants.From its SKILL.md

Install

npx -y skills add AceDataCloud/Skills --skill nano-banana-image

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
13 stars13 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.6 KB, 941 tokens by cl100k_base, as published. Nobody here has run it

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`	Improved quality, second generation
`nano-banana-pro`	Highest quality, most detailed output
`nano-banana:official`	Official channel variant of `nano-banana`
`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"`, `"nano-banana-pro"`, `"nano-banana: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

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.