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

Обзор

api_yi_nano_banana_node — это легковесный пользовательский узел ComfyUI, созданный участником сообщества JerrIsTheBesta. Он делает ставку на «простоту внедрения + легкость расширения». Просто поместите его в каталог custom_nodes, перезапустите ComfyUI, и вы сможете напрямую вызывать генерацию изображений Nano Banana Pro / Nano Banana 2 от APIYI в своем рабочем процессе — отличная отправная точка для обучения и настройки.
Информация о проекте
  • 🔗 Источник: github.com/JerrIsTheBesta/api_yi_nano_banana_node
  • 📜 Лицензия: MIT
  • 👤 Автор: JerrIsTheBesta
  • ⭐ Предоставлено партнером сообщества — позиционируется как пример, который вы можете расширить
Для кого это?Этот узел ориентирован на две наиболее распространенные операции: преобразование текста в изображение и редактирование нескольких изображений. Код минимален и легко читается. Если вам нужны более богатые возможности (редактирование в диалоге, смешивание 14 изображений и т. д.), посмотрите полнофункциональный узел Nano Banana для ComfyUI или форкните этот и расширьте его.

Основные возможности

Два основных узла

APIYI Text to Image + APIYI Multi Image Edit — охватывают два наиболее распространённых сценария

Переключение между двумя моделями

Выберите gemini-3-pro-image (Nano Banana Pro) или gemini-3.1-flash-image

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

Поддерживается вывод в разрешении 2K / 4K с автоматической настройкой тайм-аута в зависимости от разрешения

Разнообразие соотношений сторон

Встроенные форматы 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:4, 4:5 — всего 10 соотношений

Редактирование нескольких изображений

Multi Image Edit принимает до 5 эталонных изображений для смешивания / переноса стиля

Лёгкость и возможность модификации

Чистый Python с минимумом зависимостей (requests / Pillow / numpy). Понятная структура, которую легко настраивать

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

Сведения об узлах

APIYI: текст в изображение

Создаёт изображения по текстовому prompt — входное изображение не требуется. Результат: созданное изображение и идентификатор имени файла.

APIYI: редактирование нескольких изображений

Принимает до 5 входных изображений для смешивания, редактирования или создания композиции. Результат: итоговое изображение, имя файла и количество фактически использованных изображений.

Параметры узла

Установка

1

Шаг 1: Поместите в custom_nodes

Внутри вашей установки ComfyUI клонируйте репозиторий в custom_nodes:
2

Шаг 2: Установите Python-зависимости

Зависимостей минимум — обычно в ComfyUI уже входит torch. Установите остальное, если чего-то не хватает:
3

Шаг 3: Перезапустите ComfyUI

После перезапуска найдите APIYI в палитре узлов, чтобы найти:
  • APIYI Text to Image
  • APIYI Multi Image Edit
4

Шаг 4: Настройте ключ APIYI

  • Перейдите в APIYI Console → Tokens и создайте отдельный ключ с лимитом использования (лучшая практика безопасности)
  • Вставьте ключ в поле api_key узла
  • Настраивать endpoint не нужно — узел использует https://api.apiyi.com внутри
5

Шаг 5: Соберите простой workflow

  • Text-to-image: APIYI Text to Image → Preview Image
  • Multi-image edit: несколько Load Image → APIYI Multi Image Edit → Preview Image

Примеры использования

Пример 1: Текст в изображение

Пример 2: Смешивание нескольких изображений

Идеи расширения

Этот проект позиционируется как пример и отправная точка — сделайте fork и дорабатывайте по мере необходимости:

Диалоговое редактирование

Сохраняйте контекст сессии внутри узла для итеративной доработки

Больше референсных изображений

Увеличьте лимит до 14 изображений, чтобы соответствовать полной емкости Nano Banana Pro

Управление seed

Добавьте параметр seed для воспроизводимых генераций

Пакетный вывод

Выводите пакеты изображений в последующие узлы ComfyUI

FAQ

  1. Убедитесь, что репозиторий находится внутри ComfyUI/custom_nodes/
  2. Полностью перезапустите ComfyUI (не просто обновите фронтенд)
  3. Проверьте консоль ComfyUI на наличие ошибок импорта Python
Проверьте:
  1. api_key указан правильно и не ограничен неправильным каналом
  2. Выбранная модель есть в белом списке token
  3. Баланс аккаунта достаточен — см. Баланс кажется достаточным, но вызовы завершаются с ошибкой
Узел автоматически увеличивает тайм-аут для 4K, но если это все равно не помогает:
  1. Проверьте сетевой путь к API (см. Загрузка изображений/видео через CDN идет медленно)
  2. Переключитесь на 2K или Flash в часы пик
Автор прямо рекомендует не использовать ваш основной ключ — создайте для этого узла отдельный token с лимитом использования в консоли APIYI, чтобы при утечке зона возможного ущерба была ограничена.
  • Этот узел: легковесный пример, только 2 узла, минимальные зависимости — идеально для начала работы и настройки
  • Полная версия: более богатый набор возможностей (диалоговое редактирование, смешивание 14 изображений), создана для рабочих процессов production

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

Nano Banana Pro API

Полный справочник по API для Nano Banana Pro

Full ComfyUI Node

Полнофункциональный пакет узлов Nano Banana для ComfyUI

Обзор сценариев

Ознакомьтесь с другими сценариями APIYI

APIYI Console

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