Обзор
Comfyui-LuckNanoBananaPro — это пользовательский узел ComfyUI, внесенный участником сообщества luckdvr. Он вызывает Gemini 3 Pro Image Preview / Flash через APIYI для генерации изображений по тексту и редактирования нескольких изображений. По сравнению с базовыми узлами его главное преимущество — инженерная отточенность: встроенные timeout/retry, отображение прогресса в реальном времени, нативные режимы seed ComfyUI и до 14 входных изображений в стеке — идеально для более тяжелых production-процессов.
Информация о проекте
- 🔗 Источник:
github.com/luckdvr/Comfyui-LuckNanoBananaPro - 📜 Лицензия: MIT / Apache-2.0 (dual)
- 👤 Автор: luckdvr
- ⭐ Вклад сообщества, создано для APIYI
Основные возможности
До 14 входных изображений
image_01 ~ image_14 слота позволяют загрузить до 14 референсных изображений, что соответствует теоретическому пределу входных данных Nano Banana ProМногоуровневое разрешение
1K / 2K / 4K вывод с адаптивным таймаутом — баланс скорости и качества
15 соотношений сторон
Богатый набор пресетов, охватывающих вертикальный, горизонтальный, квадратный и кинематографический широкоформатный режимы
Переключение между двумя моделями
Переключайте между
gemini-3-pro-image-preview (Pro) и gemini-3.1-flash-image-preview (Flash)Таймаут и повторные попытки
timeout_seconds (10-600s) + retry_times (1-20) — стабильно даже в часы пикПрогресс в реальном времени
Встроенное отображение статуса / процента / прошедшего времени — больше никаких непрозрачных запусков
Нативные режимы seed
Поддерживает стандартные в ComfyUI шаблоны seed: фиксированный / случайный / с увеличением / с уменьшением
Двойная лицензия MIT / Apache-2.0
Либеральная лицензия — коммерческое использование и производные работы приветствуются
Поддерживаемые модели APIYI
Параметры узла
Installation
1
Шаг 1: Клонируйте в custom_nodes
Внутри вашей установки ComfyUI:
2
Шаг 2: Установите зависимости
3
Шаг 3: Перезапустите ComfyUI
Найдите
Luck Nano Banana Pro в палитре узлов.4
Шаг 4: Настройте ключ APIYI
- Перейдите в APIYI Console → Токены, создайте отдельный ключ с лимитом использования (лучшая практика)
- Вставьте ключ в поле
api_key - Узел уже указывает на
api.apiyi.com— настройка эндпоинта не требуется
5
Шаг 5: Соберите свой workflow
- Текст-в-изображение: просто укажите
prompt, оставьте входы изображений пустыми - Редактирование нескольких изображений: подключите несколько
Load Imageкimage_01,image_02и т. д., с prompt, описывающим правку
Примеры использования
Пример 1: Текст-в-изображение с высокой стабильностью
Пример 2: Смешивание нескольких изображений
Пример 3: Перебор seed
Используйте встроенное управление seed в режимеincrement, чтобы пакетно запускать несколько seed и сравнивать варианты одного и того же prompt.
Часто задаваемые вопросы
Не найден узел после установки?
Не найден узел после установки?
- Убедитесь, что репозиторий находится в
ComfyUI/custom_nodes/Comfyui-LuckNanoBananaPro - Зависимости установлены без ошибок (особенно requests / Pillow / numpy)
- Полностью перезапустите ComfyUI (одного обновления недостаточно)
4K часто уходит в таймаут?
4K часто уходит в таймаут?
Узел позволяет настраивать
timeout_seconds напрямую:- Начните с
timeout_seconds=300для 4K - Используйте вместе с
retry_times=5для автоматических повторов при сетевых флуктуациях - Если по-прежнему нестабильно, см. Скачивание изображений/видео с CDN медленное, чтобы оптимизировать сетевой путь
Будут ли использоваться все 14 reference images?
Будут ли использоваться все 14 reference images?
Вы можете подключить до 14, но будут ли они фактически использованы зависит от вашего prompt. Явно укажите их в prompt (например,
image_01, image_02) или опишите роль каждого — model учтет ваши указания.Вызовы возвращают 401 / 403?
Вызовы возвращают 401 / 403?
- Проверьте
api_keyи убедитесь, что он не ограничен неправильным каналом - Выбранный model должен быть в белом списке token
- Баланс аккаунта — см. Баланс вроде достаточный, но вызовы не проходят
Чем это отличается от двух других узлов Nano Banana для ComfyUI?
Чем это отличается от двух других узлов Nano Banana для ComfyUI?
- nano-banana-comfyui (полнофункциональный): делает акцент на диалоговом редактировании и памяти между несколькими ходами
- apiyi-nano-banana-node (lite): минимальный код, отлично подходит для обучения/настройки
- Luck Nano Banana Pro (эта страница): инженерные параметры (timeout / retry / 14 images), создан для пакетной обработки и production
Связанные ресурсы
Nano Banana Pro API
Полные возможности модели и справочник API
Luck GPT-Image 2 (тот же автор)
Узлы ComfyUI линейки OpenAI от luckdvr:
gpt-image-2 + gpt-image-2-allКоллекция узлов ComfyUI
Просмотрите все узлы Nano Banana для ComfyUI
FAQ: медленная загрузка с CDN
Изображения 4K загружаются медленно? Прочитайте это
APIYI Console
Управляйте ключами, использованием и каналами