К основному содержанию
скилл CX Codex

nano-banana-image — скилл для Claude Code: что делает и как установить

Скилл nano-banana-image генерирует и правит изображения через API AceDataCloud: промпт текстом, референсы ссылками, вывод в 1K, 2K или 4K.

Apache-2.0 232 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill nano-banana-image -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/nano-banana-image/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/nano-banana-image/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
nano-banana-pro-openrouter официальный github Скилл nano-banana-pro-openrouter для GitHub Copilot генерирует изображения по промпту, редактирует одно изображение и объединяет до трёх картинок через OpenRouter на Gemini 3 Pro Image. CX Codex +1 9 910установок nano-banana 101-skills Скилл nano-banana для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — запускает генерацию изображений через нативные модели Google Gemini по CLI inference.sh. CX Codex +1 241установок nano-banana-pro intellectronica Скилл nano-banana-pro для Claude Code создаёт и редактирует изображения через Gemini 3 Pro Image API из терминала. Генерирует иллюстрации или правит готовые файлы. CX Codex +1 3 200установок nano-banana-2 intellectronica Скилл запускает генерацию и редактирование изображений через API Nano Banana 2: задаёте промпт, разрешение и соотношение сторон. CX Codex +1 920установок nano-banana-edit prime-skills Скилл nano-banana-edit редактирует изображения через Google Nano Banana 2 на RunComfy с сохранением объекта, заменой фона и пакетом до 20 картинок. CX Codex +1 447 900установок nano-banana-pro-prompts-recommend-skill YouMind-OpenLab Скилл nano-banana-pro-prompts-recommend-skill для Claude Code подбирает промпты из библиотеки 10 000+ текстов для генерации изображений. Промпты для Nano Banana Pro совместимы с DALL-E, Midjourney, Stable Diffusion и Flux. CX Codex +1 1установок

Из того же набора67

Весь набор →
wan-video Скилл wan-video генерирует видео по тексту или анимирует картинки через API AceDataCloud с моделями Wan от Alibaba. CX Codex +1 238установок producer-music Скилл producer-music генерирует музыку через AceDataCloud API: песни, тексты, каверы и инструментальные треки. Работает с продолжением, заменой фрагментов и разделением дорожек. CX Codex +1 236установок hailuo-video Скилл hailuo-video генерирует видео из текста или анимирует картинки через API Hailuo (MiniMax) от AceDataCloud. Работает через три модели: текст-в-видео, картинка-в-видео и режим режиссёра для точного контроля над камерой. CX Codex +1 235установок seedream-image Скилл seedream-image для Claude Code подключает Seedream 5.0 для генерации, редактирования и разложения изображений на слои. Обрабатывает референсы, создаёт изображения с прозрачным фоном и серии картинок. CX Codex +1 235установок tencentcloud-cos Управляет бакетами и объектами Tencent Cloud COS: загружает, скачивает, копирует и удаляет файлы. Выполняет задачи объектного хранилища из агента. CX Codex +1 232установок google-search Скилл google-search ищет в Google страницы, картинки, новости, места и видео через API AceDataCloud и отдаёт агенту ссылки с заголовками и сниппетами. CX Codex +1 232установок google-gmail Скилл google-gmail позволяет искать письма Gmail, разбирать цепочки и работать с метками и вложениями. Отправка и архивирование требуют соответствующих разрешений и подтверждения пользователя. CX Codex +1 231установок ai-chat Скилл ai-chat подключает шлюз AceDataCloud к агенту для вызова более 50 моделей LLM через единый API. Запускается при запросах к Claude, GPT, Gemini, DeepSeek или Kimi с сохранением контекста и стримингом. CX Codex +1 230установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой