{"id":"ae05843e-32df-4878-8d66-6c434c91ce76","shortId":"eE9S8Q","kind":"skill","title":"nano-banana-image","tagline":"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, and nano-banana-pro models.","description":"# NanoBanana Image Generation\n\nGenerate and edit AI images through AceDataCloud's NanoBanana (Gemini-based) API.\n\n> **Setup:** See [authentication](../_shared/authentication.md) for token setup.\n\n## Quick Start\n\n```bash\ncurl -X POST https://api.acedata.cloud/nano-banana/images \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"action\": \"generate\", \"prompt\": \"a watercolor painting of a French countryside village\", \"model\": \"nano-banana\"}'\n```\n\n> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /nano-banana/tasks` with `{\"id\": \"...\"}`.\n## Models\n\n| Model | Best For |\n|-------|----------|\n| `nano-banana` | Standard image generation (default) |\n| `nano-banana-2` | Improved quality, second generation |\n| `nano-banana-pro` | Highest quality, most detailed output |\n\n## Workflows\n\n### 1. Text-to-Image\n\n```json\nPOST /nano-banana/images\n{\n  \"action\": \"generate\",\n  \"prompt\": \"a photorealistic macro shot of morning dew on a spider web\",\n  \"model\": \"nano-banana-pro\",\n  \"aspect_ratio\": \"16:9\",\n  \"resolution\": \"2K\"\n}\n```\n\n### 2. Image Editing\n\nEdit existing images using natural language instructions — no mask needed. Pass source images via `image_urls`.\n\n```json\nPOST /nano-banana/images\n{\n  \"action\": \"edit\",\n  \"prompt\": \"change the background to a starry night sky\",\n  \"image_urls\": [\"https://example.com/photo.jpg\"],\n  \"model\": \"nano-banana\"\n}\n```\n\n## Parameters\n\n| Parameter | Values | Description |\n|-----------|--------|-------------|\n| `action` | `\"generate\"`, `\"edit\"` | Operation mode |\n| `model` | `\"nano-banana\"`, `\"nano-banana-2\"`, `\"nano-banana-pro\"` | Model to use |\n| `prompt` | string | Image description or editing instruction |\n| `image_urls` | array of strings | Source image URLs (required for edit action) |\n| `aspect_ratio` | `\"1:1\"`, `\"3:2\"`, `\"2:3\"`, `\"16:9\"`, `\"9:16\"`, `\"4:3\"`, `\"3:4\"` | Output aspect ratio |\n| `resolution` | `\"1K\"`, `\"2K\"`, `\"4K\"` | Output resolution (1K=1024px, 2K=2048px, 4K=4096px) |\n| `callback_url` | string | Async callback URL; returns a task ID immediately |\n\n## Gotchas\n\n- Editing does **NOT** require a mask — just describe the change in natural language\n- Editing uses the same `/nano-banana/images` endpoint with `action: \"edit\"` and `image_urls` array (not a separate `/edit` path)\n- `nano-banana-2` is the second-generation model; `nano-banana-pro` offers the highest quality\n- Task polling uses `id` (not `task_id`) in the `/nano-banana/tasks` request body\n- Aspect ratio uses colon notation (e.g., `\"16:9\"`) not pixel dimensions\n- The Gemini-based model excels at understanding complex, conversational editing instructions\n\n> **MCP:** `pip install mcp-nano-banana` | Hosted: `https://nano-banana.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)","tags":["nano","banana","image","skills","acedatacloud","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video"],"capabilities":["skill","source-acedatacloud","skill-nano-banana-image","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/nano-banana-image","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (2,817 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:03.281Z","embedding":null,"createdAt":"2026-05-18T13:21:34.038Z","updatedAt":"2026-05-18T19:14:03.281Z","lastSeenAt":"2026-05-18T19:14:03.281Z","tsv":"'/_shared/async-tasks.md':110 '/_shared/authentication.md':65 '/_shared/mcp-servers.md':406 '/edit':336 '/mcp':401 '/nano-banana/images':77,153,200,324 '/nano-banana/tasks':114,365 '/photo.jpg':216 '1':146,266,267 '1024px':290 '16':175,272,275,374 '1k':284,289 '2':39,131,179,237,269,270,341 '2048px':292 '2k':178,285,291 '3':268,271,277,278 '4':276,279 '4096px':294 '4k':286,293 '9':176,273,274,375 'acedatacloud':16,55,81 'action':90,154,201,225,263,327 'ai':8,52 'api':17,61,82 'api.acedata.cloud':76 'api.acedata.cloud/nano-banana/images':75 'application/json':88 'array':254,332 'aspect':173,264,281,368 'async':105,107,298 'authent':64 'author':79 'background':206 'banana':3,35,38,43,104,123,130,138,171,220,233,236,240,340,350,397 'base':14,60,382 'bash':71 'bearer':80 'best':119 'bodi':367 'callback':295,299 'chang':204,316 'colon':371 'complex':387 'content':86 'content-typ':85 'convers':388 'countrysid':99 'creat':20 'curl':72 'd':89 'default':127 'describ':314 'descript':224,248 'detail':143 'dew':163 'dimens':378 'e.g':373 'edit':7,26,51,181,182,202,227,250,262,307,320,328,389 'endpoint':325 'example.com':215 'example.com/photo.jpg':214 'excel':384 'exist':27,183 'french':98 'gemini':13,59,381 'gemini-bas':12,58,380 'generat':5,48,49,91,126,135,155,226,346 'gotcha':306 'h':78,84 'highest':140,354 'host':398 'id':116,304,359,362 'imag':4,9,21,28,47,53,125,150,180,184,194,196,212,247,252,258,330 'immedi':305 'improv':132 'instal':393 'instruct':31,188,251,390 'json':151,198 'languag':187,319 'macro':159 'mask':190,312 'mcp':391,395,404 'mcp-nano-banana':394 'mode':229 'model':45,101,117,118,168,217,230,242,347,383 'morn':162 'nano':2,34,37,42,103,122,129,137,170,219,232,235,239,339,349,396 'nano-banana':33,36,102,121,128,218,231,234,338 'nano-banana-imag':1 'nano-banana-pro':41,136,169,238,348 'nano-banana.mcp.acedata.cloud':400 'nano-banana.mcp.acedata.cloud/mcp':399 'nanobanana':11,46,57 'natur':186,318 'need':191 'night':210 'notat':372 'offer':352 'oper':228 'output':144,280,287 'paint':95 'paramet':221,222 'pass':192 'path':337 'photorealist':158 'pip':392 'pixel':377 'poll':109,111,357 'post':74,113,152,199 'pro':44,139,172,241,351 'prompt':24,92,156,203,245 'qualiti':133,141,355 'quick':69 'ratio':174,265,282,369 'request':366 'requir':260,310 'resolut':177,283,288 'return':301 'second':134,345 'second-gener':344 'see':63,106,402 'separ':335 'server':405 'setup':62,68 'shot':160 'skill' 'skill-nano-banana-image' 'sky':211 'sourc':193,257 'source-acedatacloud' 'spider':166 'standard':124 'starri':209 'start':70 'string':246,256,297 'support':32 'task':108,303,356,361 'text':23,30,148 'text-to-imag':147 'token':67,83 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'type':87 'understand':386 'url':197,213,253,259,296,300,331 'use':18,185,244,321,358,370 'valu':223 'via':15,112,195 'villag':100 'watercolor':94 'web':167 'workflow':145 'x':73","prices":[{"id":"955e5b85-38d9-4753-8efc-107ea3657167","listingId":"ae05843e-32df-4878-8d66-6c434c91ce76","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:34.038Z"}],"sources":[{"listingId":"ae05843e-32df-4878-8d66-6c434c91ce76","source":"github","sourceId":"AceDataCloud/Skills/nano-banana-image","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/nano-banana-image","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:34.038Z","lastSeenAt":"2026-05-18T19:14:03.281Z"}],"details":{"listingId":"ae05843e-32df-4878-8d66-6c434c91ce76","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"nano-banana-image","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"736335b60e0e4e9b92e32db085b779f92cb83522","skill_md_path":"skills/nano-banana-image/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/nano-banana-image"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"nano-banana-image","license":"Apache-2.0","description":"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, and nano-banana-pro models.","compatibility":"Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-nano-banana for tool-use."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/nano-banana-image"},"updatedAt":"2026-05-18T19:14:03.281Z"}}