Nano Banana API и MCP: как подключить генерацию изображений к своему проекту

Nano Banana — семейство моделей генерации изображений. На NeuralSpace доступны модели: Nano Banana, Nano Banana Pro, Nano Banana 2, Nano Banana 2 Lite. Все они работают через единый публичный API, а для ИИ-агентов есть готовый MCP-сервер. Ключ выдаётся на странице API-ключей.

Что умеет Nano Banana

Nano Banana генерирует изображения по текстовому описанию. Базовая версия выдаёт картинку 1K, Pro и 2 поддерживают разрешения 1K, 2K и 4K, а 2 Lite — облегчённая версия с выходом 1K. Модели поддерживают редактирование и референсы через параметр image_urls.

Эндпоинт API

Запрос отправляется на POST /v1/images/generations. Пример: {"model": "nano-banana-2", "prompt": "кот на подоконнике", "resolution": "1K"}. Авторизация — по API-ключу в заголовке x-api-key. Доступные id моделей: nano-banana, nano-banana-pro, nano-banana-2, nano-banana-2-lite.

MCP-инструменты

MCP-сервер NeuralSpace доступен по адресу POST /mcp (Streamable HTTP). Для работы с Nano Banana агент использует инструменты: generate_image, list_models, get_balance. Это позволяет Claude Code, Cursor и другим MCP-клиентам пользоваться моделями сайта напрямую.

Как подключить

Зарегистрируйтесь на NeuralSpace, откройте API-ключей и создайте ключ формата nsk-…. Дальше передавайте его в заголовке запроса или в настройках MCP-клиента. Полная документация — на странице /v1/docs.

Частые вопросы

Какие разрешения доступны?

Базовая и Lite — 1K, Pro и 2 — 1K, 2K и 4K.

Можно ли редактировать картинку?

Да, через параметр image_urls передаются исходные изображения.

Сколько стоит генерация?

Цена зависит от модели и разрешения, точная сумма видна в документации.