nano-banana-image — скилл для Claude Code: что делает и как установить
Скилл nano-banana-image генерирует и правит изображения через API AceDataCloud: промпт текстом, референсы ссылками, вывод в 1K, 2K или 4K.
Apache-2.0 232 установок ★ 17 обновлён 2026-10-25
npx skills add AceDataCloud/Skills --skill nano-banana-image -a claude-codeЧто делает nano-banana-image
Скилл сводит работу агента к одному эндпоинту: POST /nano-banana/images с action: "generate" или action: "edit". Во втором случае исходники перечисляют в image_urls, а правку описывают словами — маску рисовать не нужно.
Модели идут от nano-banana до nano-banana-pro; у части есть вариант :official, он отправляет запрос через официальный канал. Разрешение задаётся полем resolution (1K, 2K, 4K), пропорции — aspect_ratio в записи вида 16:9. У nano-banana и nano-banana-2-lite доступен только 1K, а nano-banana-2, 2.1 и pro принимают все три.
До первого вызова нужен ACEDATACLOUD_API_TOKEN в окружении агента и HTTPS до api.acedata.cloud; ключ берут в консоли AceDataCloud, управляющий токен вида platform-... вместо него не подойдёт. Если поле model не заполнить, запрос уйдёт на nano-banana, поэтому nano-banana-2.1 прописывают явно. Асинхронный ответ возвращает id задачи, и опрашивать её нужно ключом id в POST /nano-banana/tasks, а не task_id.
Какие задачи решает
- сгенерировать обложку по текстовому описанию в пропорциях 16:9
- заменить фон на фотографии, не рисуя маску
- получить тот же кадр в 4K для печати
- сравнить выдачу двух моделей на одном промпте
- дождаться асинхронной задачи, не отправляя платный запрос заново
Примеры запросов агенту
- Нарисуй акварельную деревню через
nano-banana-2.1, соотношение 16:9, разрешение 2K. - Поменяй фон на звёздное небо: правка через
action: "edit", исходник вimage_urls. - Отправь запрос асинхронно и опроси задачу по
idв/nano-banana/tasks.
Как установить nano-banana-image
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill nano-banana-image -a claude-code2Вручную: положить файлы
~/.claude/skills/nano-banana-image/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/nano-banana-image/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill nano-banana-image -a codex2Вручную: положить файлы
.agents/skills/nano-banana-image/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill nano-banana-image -a cursor2Вручную: положить файлы
.cursor/skills/nano-banana-image/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/nano-banana-image2Вручную: положить файлы
.github/skills/nano-banana-image/SKILL.md1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill nano-banana-image -a gemini-cli2Командой платформы
gemini skills install https://github.com/AceDataCloud/Skills --path skills/nano-banana-imageВручную: положить файлы
.devin/skills/nano-banana-image/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill nano-banana-image -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о nano-banana-image
Как установить nano-banana-image в Claude Code?
Выполните npx skills add AceDataCloud/Skills --skill nano-banana-image -a claude-code. Скилл появится по пути ~/.claude/skills/nano-banana-image/SKILL.md.
Что делает nano-banana-image?
Даёт агенту генерацию картинок по промпту и правку готовых изображений через API AceDataCloud на моделях NanoBanana. Для правки хватает текстового описания и ссылок на исходники.
Что нужно, чтобы скилл заработал?
Переменная ACEDATACLOUD_API_TOKEN с сервисным ключом из консоли AceDataCloud и доступ по HTTPS к api.acedata.cloud.
Исходный текст
SKILL.md · Apache-2.0
---
name: nano-banana-image
description: Nano Banana image by Ace Data Cloud. Generate and edit images with Nano Banana, Nano Banana 2.1 or Pro. Use when the user asks for Nano Banana or NanoBanana image generation, reference-image editing or 1K, 2K and 4K output.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN in the agent process environment and HTTPS access to api.acedata.cloud. See README.md for installation and key setup.
---
# Nano Banana by Ace Data Cloud
Generate and edit AI images through AceDataCloud's NanoBanana (Gemini-based) API.
## Install and connect from skills.sh
This integration is maintained by **Ace Data Cloud**; it is not an official Nano Banana publisher listing. Install only this Skill with `npx skills add acedatacloud/skills --skill nano-banana-image --yes`, or use the [public skills.sh page](https://skills.sh/acedatacloud/skills/nano-banana-image). Keep the slug `nano-banana-image` when selecting it.
Read the [illustrated first-run guide](README.md) ([简体中文](readme.zh-CN.md)) for registration, **Applications → General application**, API key access and price checks, and the environment variable location for your coding agent. For skills.sh installations, use this guide; any ClawHub-specific setup applies only to OpenClaw. The shared references linked here are online because focused installs do not include sibling `_shared/` folders.
## ClawHub / OpenClaw setup
1. Install the official Skill with `clawhub install @acedatacloud/nano-banana`. Check that the ClawHub publisher is **@acedatacloud**.
2. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications), open **General application**, and check Nano Banana access, balance, and current pricing. Copy its API key, or select **Manage Keys → Create** for a separate key. Copy the key value without `Bearer `; a `platform-...` management token is not a service API key.
3. If you enable **Allowed APIs** restrictions, include `/nano-banana/images` and `/nano-banana/tasks`. Advanced workflows below may call additional routes.
4. On the OpenClaw Gateway host, put `ACEDATACLOUD_API_TOKEN=your_api_key_here` in `~/.openclaw/.env`, then restart the Gateway and start a new session. For a direct terminal test, run `export ACEDATACLOUD_API_TOKEN="your_api_key_here"` in that shell. Never put the key in a prompt or commit an `.env` file.
5. Run the **Quick Start** below. If this workflow returns a task ID, query that same task until it finishes; do not submit the same billable request again just to check progress.
[Illustrated key setup, first run, and troubleshooting](https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw) · [Token details](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/authentication.md)
## 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 '{"action": "generate", "prompt": "a watercolor painting of a French countryside village", "model": "nano-banana"}'
```
> **Async:** See [async task polling](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/async-tasks.md). Poll via `POST /nano-banana/tasks` with `{"id": "..."}`.
## Models
| Model | Best For |
|-------|----------|
| `nano-banana` | Standard image generation (default) |
| `nano-banana-2-lite` | Fast, lightweight second-generation model |
| `nano-banana-2` | Improved quality, second generation |
| `nano-banana-2.1` | Latest efficient model; 1K, 2K, and 4K generation and editing |
| `nano-banana-pro` | Highest quality, most detailed output |
| `nano-banana:official` | Official channel variant of `nano-banana` |
| `nano-banana-2-lite:official` | Official channel variant of `nano-banana-2-lite` |
| `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
```json
POST /nano-banana/images
{
"action": "generate",
"prompt": "a photorealistic macro shot of morning dew on a spider web",
"model": "nano-banana-2.1",
"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`.
```json
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-2.1",
"resolution": "2K"
}
```
## Parameters
| Parameter | Values | Description |
|-----------|--------|-------------|
| `action` | `"generate"`, `"edit"` | Operation mode |
| `model` | `"nano-banana"`, `"nano-banana-2-lite"`, `"nano-banana-2"`, `"nano-banana-2.1"`, `"nano-banana-pro"`, `"nano-banana:official"`, `"nano-banana-2-lite:official"`, `"nano-banana-2:official"`, `"nano-banana-pro:official"` | Model to use; 2.1 has no `:official` variant |
| `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"` | Default 1K; `nano-banana` and `nano-banana-2-lite` support only 1K; 2, 2.1, and Pro support all three resolutions |
| `callback_url` | string | Async callback URL; returns a task ID immediately |
To use 2.1, explicitly set `model:"nano-banana-2.1"`; omitting `model` still selects `nano-banana`. For nonblocking requests, set `async:true`, retain `task_id`, and poll `/nano-banana/tasks` to terminal success before returning an image. No `nano-banana-2.1:official` variant is published.
The same 2.1 model is also accepted by `POST /openai/images/generations` (public alias `/v1/images/generations`) and `POST /openai/images/edits` (public alias `/v1/images/edits`). Those use their own OpenAI-compatible schemas (`image` for JSON editing, not `image_urls`; `size` rather than this endpoint's `resolution`/`aspect_ratio`). Check that endpoint's current schema before reusing a request; do not assume identical response fields. Prices depend on the current service/package; consult live pricing rather than hard-coding a per-call USD amount.
## 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.1` supports 1K, 2K, and 4K; `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](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/mcp-servers.md)
© acedatacloud · Apache-2.0 · AceDataCloud/Skills