Для разработчиков
MCP-сервер Nano Banana Pro
Поручите ИИ-ассистенту создавать изображения и видео от вашего имени. Добавьте адрес сервера в клиент, поддерживающий Model Context Protocol, войдите в аккаунт в браузере и опишите задачу обычными словами.
Как это работает
Добавьте адрес сервера
Вставьте приведённый ниже адрес в клиент с помощью его команды, файла конфигурации или поля пользовательского коннектора.
Адрес MCP-сервера
https://preview.bananapro.site/api/mcpВойдите и разрешите доступ
Клиент откроет окно браузера. Войдите в аккаунт Nano Banana Pro и нажмите «Разрешить». Вводить ключ API не требуется.
Опишите задачу
Попросите изображение или видео в диалоге. Ассистент выберет инструмент, запустит задачу и вернёт ссылки на результат.
Настройка по клиентам
Выберите свой клиент. Названия пунктов меню могут немного отличаться в разных версиях.
Claude Code
- 1Выполните приведённую ниже команду в терминале, чтобы добавить сервер.
- 2В Claude Code откройте /mcp, выберите nanobanana и завершите вход в браузере.
claude mcp add --transport http nanobanana https://preview.bananapro.site/api/mcpCodex
- 1Выполните первую команду в терминале, чтобы добавить сервер.
- 2Выполните вторую команду. Откроется окно браузера.
- 3Войдите в аккаунт и нажмите «Разрешить».
codex mcp add nanobanana --url https://preview.bananapro.site/api/mcpcodex mcp login nanobananaCursor и клиенты с JSON
- 1Добавьте следующее в файл конфигурации MCP клиента, например в mcp.json в Cursor.
- 2При необходимости перезапустите клиент. При первом использовании откроется окно браузера: войдите и нажмите «Разрешить».
{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp"
}
}
}Пользовательский коннектор
- 1Откройте настройки клиента и найдите поле для пользовательского коннектора или удалённого MCP-сервера.
- 2Вставьте показанный ниже адрес сервера и сохраните.
- 3Нажмите «Подключить», войдите в аккаунт и нажмите «Разрешить».
https://preview.bananapro.site/api/mcpКлюч API
- 1Используйте этот способ только для клиентов, которые не могут открыть браузер.
- 2Создайте ключ на странице ключей API. Передайте его в заголовке из первого поля или добавьте в раздел headers JSON-конфигурации, как показано во втором поле.
- 3Храните ключ в настройках учётных данных клиента и никому его не передавайте.
Authorization: Bearer YOUR_API_KEY{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Что может ассистент
Сервер предоставляет шесть инструментов. Четыре только читают информацию и бесплатны; два запускают генерацию и расходуют кредиты.
| Инструмент | Назначение | Расходует кредиты |
|---|---|---|
| list_models | Показывает модели для изображений и видео, доступные вашему аккаунту, и типы запросов, которые принимает каждая из них. | Нет |
| get_balance | Показывает, сколько кредитов осталось на аккаунте. | Нет |
| generate_image | Запускает создание или редактирование изображения по промпту и, при необходимости, референсным изображениям. | Да |
| generate_video | Запускает создание видео по промпту, изображениям или другим референсным материалам. | Да |
| get_task | Проверяет состояние генерации и после её завершения возвращает ссылки на результат. | Нет |
| list_tasks | Показывает последние генерации; удобно, если идентификатор задачи утерян. | Нет |
Инструмент командной строки
Команда nanobanana создаёт изображения и видео из терминала, из скриптов и из ИИ-приложений, которые умеют выполнять команды на вашем компьютере.
Требуется Node.js 22 или новее в macOS или Linux.
Установите CLI
Установите пакет @nanobanana-pro/cli с помощью npm.
npm install -g @nanobanana-pro/cliВойдите
Выполните команду, затем войдите в аккаунт в окне браузера и нажмите «Разрешить».
nanobanana auth loginПроверьте аккаунт и модели
Эта команда показывает баланс кредитов. Команда nanobanana models выводит список доступных моделей.
nanobanana accountСоздайте
Сохраните в request.json запрос с моделью и промптом и выполните команду. Параметр --wait удерживает команду до завершения задачи.
nanobanana create --input request.json --waitСкачайте результат
Замените TASK_ID на идентификатор задачи, который вернула предыдущая команда.
nanobanana download TASK_ID --output result.png
Как это выглядит
Попросите изображение одной фразой. ИИ-приложение составит запрос, создаст изображение и сохранит файл.
$ nanobanana create --input request.json --wait
Task TASK_ID submitted; waiting for the result…
{ "status": "completed" }
$ nanobanana download TASK_ID --output result.png
{ "files": ["result.png"] }
Модели
Ассистент может использовать модели изображений и видео, доступные вашему аккаунту на сайте и в API.
- Попросите ассистента вызвать list_models, чтобы получить актуальный список моделей и типы запросов, которые принимает каждая из них.
- Каждая модель предлагает те же параметры, что и на сайте. Параметр, который модель не поддерживает, отклоняется с пояснением.
- Референсные изображения и видео должны быть общедоступными ссылками https. Загрузка файлов через MCP не поддерживается.
Кредиты и оплата
- Вход и бесплатные инструменты (list_models, get_balance, get_task, list_tasks) ничего не стоят.
- generate_image и generate_video расходуют столько же кредитов, сколько на сайте и в API, и списывают их с баланса вашего аккаунта.
- Задача, завершившаяся ошибкой, возмещается автоматически.
- Подписка на самого ИИ-ассистента оформляется отдельно и оплачивается этому ассистенту.
Примеры запросов
После подключения отправьте ассистенту один из этих запросов.
- Какие модели изображений и видео мне доступны? Покажи коротким списком.
- Создай предметное фото 16:9: керамическая кружка на деревянном столе.
- Преврати это фото пейзажа в видео длиной пять секунд: https://example.com/photo.jpg
- Проверь статус моей последней задачи и пришли ссылку на результат.
Частые вопросы
Нужен ли ключ API?
Для клиентов, которые могут открыть браузер, не нужен: достаточно войти и нажать «Разрешить». Ключ требуется только клиентам, которые этого не умеют, как описано в разделе «Ключ API».
Где посмотреть или удалить подключение?
Откройте страницу ключей API. Каждое подключение отображается там под именем своего клиента, а после удаления доступ этого клиента прекращается.
Сколько стоит одна генерация?
Столько же кредитов, сколько на сайте и в API. Задача, завершившаяся ошибкой, возмещается автоматически.
Можно ли использовать собственные изображения или видео как референсы?
Да, в виде общедоступных ссылок https. Загрузки файлов нет: разместите файл в доступном месте и передайте его адрес.
Подключение работает, но инструменты не появляются. Что делать?
Убедитесь, что вход завершён и клиент показывает сервер как подключённый. Затем начните новый диалог: некоторые клиенты загружают инструменты только в начале диалога.
Где найти результаты?
Ассистент возвращает ссылки на результат в диалоге. Прежние задачи можно снова вывести с помощью list_tasks.
Предпочитаете вызывать API самостоятельно?
MCP-сервер построен на открытом API. В документации перечислены все конечные точки, параметры и модели.