Перейти к основному содержанию

​
Обзор

ComfyUI-Nano-Banana-apiyi — это созданная сообществом коллекция custom nodes для ComfyUI, специально разработанная для пользователей APIYI. Она позволяет вызывать самые мощные модели Google для генерации изображений — Nano Banana Pro и Nano Banana 2 — напрямую в рабочих процессах ComfyUI, без необходимости в аккаунте Google Cloud. Для начала создания вам нужен только APIYI API key.
Информация о проекте
  • 🔗 Исходный код: github.com/pdmaker/ComfyUI-Nano-Banana-apiyi
  • 📜 Лицензия: MIT
  • 👤 Автор: вклад сообщества (оригинальный репозиторий был удалён; сейчас используется резервное зеркало)
  • ⭐ Вклад сообщества, адаптировано для APIYI

​
Почему этот узел

Вход без барьеров

Не требуется аккаунт Google Cloud — используйте ваш ключ APIYI для доступа к моделям Nano Banana Pro и Nano Banana 2

Мультимодальная генерация

Генерация изображений из текста, из изображения и слияние нескольких изображений (до 14 изображений-референсов) для любых творческих задач

Редактирование в чате с несколькими ходами

Уникальная диалоговая генерация изображений с памятью контекста для итеративной доработки

Сверхвысокое разрешение

Поддерживает вывод 512px, 1K, 2K и 4K с 14 соотношениями сторон, охватывая постеры, обои, социальные сети и многое другое

​
Поддерживаемые модели APIYI

Какую модель выбрать? Выберите Nano Banana Pro для максимального качества, а Nano Banana 2 — для оптимального соотношения цены и качества (стоимость — от $0.025 за изображение). Обе модели можно использовать в одном рабочем процессе ComfyUI.

​
Четыре основные ноды

Этот плагин предоставляет 4 функциональные ноды для разных сценариев использования:

​
Начало работы: установка и настройка

1

Шаг 1: Проверьте необходимые требования

Убедитесь, что у вас установлено следующее:
  • ComfyUI (последняя версия) — если не установлено, см.: github.com/comfyanonymous/ComfyUI
  • Python 3.12+
  • Git
Версия Python должна быть 3.12 или выше. Более низкие версии могут привести к сбоям при установке зависимостей.
2

Шаг 2: Скачайте код узла

Откройте терминал, перейдите в каталог custom nodes в ComfyUI и клонируйте репозиторий:
3

Шаг 3: Установите зависимости

Перейдите в каталог плагина и установите необходимые зависимости:
Для поддержки узла Nano Banana 2 также установите:
4

Шаг 4: Получите свой APIYI-ключ

  1. Перейдите в APIYI Console, чтобы зарегистрироваться или войти
  2. Перейдите в раздел Token
  3. Сгенерируйте новый API-ключ
  4. Скопируйте ключ (начинается с sk-)
Новые пользователи получают бесплатные пробные кредиты, которых достаточно, чтобы попробовать генерацию изображений Nano Banana.
5

Шаг 5: Настройте переменные окружения

В каталоге плагина скопируйте шаблонный файл и заполните свои учетные данные:
Отредактируйте файл .env, указав ваш ключ APIYI и Base URL:
Ключевая настройка: CUSTOM_BASE_URL должен быть установлен в https://api.apiyi.com, чтобы все запросы шли через APIYI — учетная запись Google Cloud не нужна. Код автоматически добавляет правильный путь версии API.
6

Шаг 6: Перезапустите ComfyUI и проверьте

После перезапуска ComfyUI найдите Nano Banana в списке узлов. Вы должны увидеть 4 новых узла:
  • Nano Banana AIO
  • Nano Banana Multi-Turn Chat
  • Nano Banana 2 AIO
  • Nano Banana 2 Multi-Turn Chat
Если вы видите эти узлы, установка выполнена успешно!

​
Практическое руководство: от текста к изображению

​
Сценарий 1: Из текста в изображение (базовый)

Самое простое использование — введите текстовое описание и сгенерируйте изображение.
1

Добавьте узел

Щелкните правой кнопкой мыши по холсту ComfyUI, найдите и добавьте узел Nano Banana AIO (или Nano Banana 2 AIO).
2

Введите prompt

Введите желаемое описание изображения в поле prompt, например:
3

Настройте параметры

  • image_count: Количество изображений для генерации (1-10)
  • aspect_ratio: Выберите соотношение сторон, например, 16:9 (обои для рабочего стола в альбомной ориентации) или 9:16 (обои для телефона)
  • image_size: Разрешение — рекомендуем 2K или 4K
  • temperature: Уровень креативности, 0.0 — наиболее консервативно, 2.0 — наиболее креативно
4

Запустите рабочий процесс

Нажмите кнопку ComfyUI Queue Prompt и подождите несколько секунд, чтобы увидеть сгенерированное изображение.

​
Сценарий 2: Редактирование и слияние изображений

Используйте референсные изображения для управления генерацией — отлично подходит для переноса стиля, слияния элементов и многого другого.
  1. Подключите ваши референсные изображения к входам image_1 и image_6 узла Nano Banana AIO
  2. Опишите желаемый эффект в prompt, например: «Преобразуйте это фото в стиль акварельной живописи»
  3. Модель объединяет референсные изображения и текстовое описание для генерации новых изображений
Nano Banana 2 AIO Exclusive: Поддерживает до 14 референсных изображений (10 объектов + 4 референса для согласованности персонажа), идеально подходит для творческих проектов, где требуется единообразный внешний вид персонажа.

​
Сценарий 3: Многоходовое диалоговое редактирование

Самая уникальная функция — пошагово дорабатывайте изображения, как в чате.
  1. Добавьте узел Nano Banana Multi-Turn Chat
  2. Раунд 1: Введите первоначальное описание, создайте базовое изображение
  3. Раунд 2: Введите изменение, например: «Измените фон на пляж»
  4. Раунд 3: Продолжайте уточнять, например: «Добавьте освещение на закате»
  5. Каждый раунд опирается на память беседы
Переключите reset_chat, чтобы очистить историю беседы и начать заново.

​
Справочник параметров узла

​
Nano Banana AIO / Nano Banana 2 AIO

​
Поддерживаемые соотношения сторон

​
FAQ

Проверьте следующее:
  1. Папка плагина находится в каталоге ComfyUI/custom_nodes/
  2. Вы выполнили pip3 install -r requirements.txt
  3. Для узлов Nano Banana 2 также выполните pip install google-genai --upgrade
  4. Вы перезапустили ComfyUI (недостаточно просто обновить страницу в браузере — перезапустите серверную часть)
Проверьте следующее:
  1. GOOGLE_API_KEY в файле .env — это ваш ключ APIYI (начинается с sk-)
  2. Для CUSTOM_BASE_URL задано значение https://api.apiyi.com
  3. На вашем аккаунте APIYI достаточно средств (проверьте баланс в консоли)
  • Генерация в разрешении 4K занимает больше времени — для проверки сначала попробуйте 1K
  • Несколько изображений (значение image_count больше 1) увеличивают время обработки
  • Если тайм-ауты возникают часто, попробуйте снизить разрешение или уменьшить количество изображений
  • Nano Banana Pro (gemini-3-pro-image): более высокое качество, идеально подходит для премиальных работ
  • Nano Banana 2 (gemini-3.1-flash-image): быстрее и дешевле (от $0.025 за изображение), поддерживает больше референсных изображений и экстремальные соотношения сторон
  • Для повседневной работы рекомендуется Nano Banana 2; если важно максимальное качество, выберите Pro
Перейдите в консоль APIYI, зарегистрируйте аккаунт и создайте новый ключ в разделе «Токен». Новые пользователи получают бесплатные пробные средства.
В моделях Nano Banana встроены проверки безопасности контента. Некоторые описания могут активировать ограничения. Рекомендации:
  1. Измените prompt, чтобы исключить чувствительный контент
  2. Дополнительные сведения см. в статье Устранение неполадок при генерации изображений с Nano Banana

​
Связанные ресурсы

Документация Nano Banana Pro

Посмотреть полную API-документацию и тарифы Nano Banana Pro

Документация Nano Banana 2

Посмотреть полную API-документацию и тарифы Nano Banana 2

Устранение неполадок при сбое генерации изображений

Руководство по устранению неполадок при генерации изображений Nano Banana

APIYI - Управление token

Управляйте API-ключами, просматривайте использование и баланс