Использование модели генерации изображений Gemini в ComfyUI — это потребность многих авторов. В этой статье мы расскажем, как в 3 шага подключить Nano Banana 2 к ComfyUI для реализации рабочих процессов текст-в-изображение, изображение-в-изображение и других, а также поддерживать переключение одним кликом между моделями всей серии NB2, NB Pro, NB.
Ключевая ценность: Прочитав эту статью, вы научитесь настраивать API для генерации изображений Gemini в ComfyUI, освоите методы переключения моделей и быстро создавать рабочие процессы для генерации AI-изображений.

Ключевые моменты подключения Nano Banana 2 к ComfyUI
Nano Banana 2 (gemini-3.1-flash-image-preview) — это новейшая модель генерации изображений от Google, которую можно легко подключить через пользовательские узлы ComfyUI.
| Пункт | Описание | Ценность |
|---|---|---|
| Установка плагина | Поддерживает различные пользовательские узлы ComfyUI | Гибкий выбор подходящего решения |
| Настройка API | Достаточно установить base_url и API-ключ | Настройка занимает 5 минут |
| Переключение моделей | Нужно только изменить параметр model | Переключение одним кликом между моделями всей серии |
| Рабочий процесс | Текст-в-изображение, изображение-в-изображение, перенос стиля | Охватывает основные сценарии творчества |
Подробное описание ключевых моментов подключения Nano Banana 2 к ComfyUI
Суть подключения Nano Banana 2 к ComfyUI заключается в правильном выборе плагина + правильной настройке API. В отличие от прямого вызова официального API Google, через унифицированный интерфейс APIYI apiyi.com вы можете беспрепятственно использовать все модели генерации изображений Gemini в ComfyUI, без необходимости решать сложные проблемы с сетью и аутентификацией.
Схема подключения по сути такая же, как и для Nano Banana Pro, единственное отличие — это название модели. Если вы ранее уже настраивали NB Pro, вам просто нужно изменить имя модели на gemini-3.1-flash-image-preview.
Почему стоит выбрать подключение Nano Banana 2 через ComfyUI
По сравнению с прямым вызовом API или использованием других инструментов, подключение через ComfyUI имеет следующие уникальные преимущества:
- Визуальный рабочий процесс: Узловой подход, WYSIWYG (что видишь, то и получаешь), удобство отладки.
- Возможность пакетной обработки: Поддерживает пакетную генерацию в очереди, подходит для больших объемов изображений.
- Повторное использование рабочих процессов: Создайте рабочий процесс один раз, используйте его многократно, повышая эффективность.
- Высокая расширяемость: Может комбинироваться с другими узлами ComfyUI для постобработки, суперразрешения и т.д.
- Локальное выполнение: Рабочий процесс выполняется локально, только вызовы API идут по сети, данные более безопасны.
Сравнение всей серии моделей Nano Banana 2
Прежде чем интегрировать ComfyUI, давайте ознакомимся со всей серией моделей генерации изображений Gemini, предлагаемых APIYI:
| Параметр сравнения | Nano Banana 2 | Nano Banana Pro | Nano Banana |
|---|---|---|---|
| Название модели | gemini-3.1-flash-image-preview | gemini-3-pro-image-preview | gemini-2.5-flash-image |
| Уровень качества изображения | Качество Pro-уровня | Высочайшее качество | Отличное качество |
| Скорость генерации | Самая быстрая | Медленнее | Быстрая |
| Максимальное разрешение | 4K | 4K | 2K |
| Соотношение сторон | 14 видов | 10 видов | 10 видов |
| Эксклюзивные функции | Grounding для поиска изображений | — | — |
| Цена APIYI | $0.03/вызов | $0.05/вызов | $0.025/вызов |
| Статус | Preview | Preview | GA |

Соотношение сторон, поддерживаемые Nano Banana 2
Nano Banana 2 поддерживает 14 видов соотношений сторон, что является наибольшим количеством среди трёх моделей. Выбрать их можно в параметре aspect_ratio узла ComfyUI:
| Соотношение сторон | Сценарии применения | Соотношение сторон | Сценарии применения |
|---|---|---|---|
| 1:1 | Аватары, социальные сети | 9:16 | Обои для телефона, обложки для коротких видео |
| 16:9 | Горизонтальные обложки, обои для рабочего стола | 3:4 | Вертикальные постеры |
| 4:3 | Традиционное соотношение сторон для фото | 2:3 | Портретная фотография |
| 3:2 | Пейзажные фотографии | 9:21 | Сверхдлинный вертикальный формат |
| 21:9 | Сверхширокий экран | 4:5 | |
| 5:4 | Квадратный с горизонтальной ориентацией | 16:10 | Соотношение сторон монитора |
| 10:16 | Вертикальный баннер | Пользовательское | Настраивается по необходимости |
🎯 Рекомендации по выбору: Nano Banana 2 достигает оптимального баланса между качеством изображения и скоростью, поэтому рекомендуется как предпочтительная модель для повседневного творчества в ComfyUI. Через APIYI (apiiyi.com) вы можете получить единый API-интерфейс для всех моделей серии, что позволяет легко переключаться между ними в любое время.
Выбор плагинов Nano Banana 2 для ComfyUI
Сейчас есть несколько плагинов ComfyUI, поддерживающих генерацию изображений Gemini. Мы рекомендуем следующие два варианта:
Вариант A: Плагин ComfyUI-IF_Gemini (рекомендуется)
ComfyUI-IF_Gemini — это самый зрелый узел Gemini для ComfyUI на данный момент. Он нативно поддерживает конфигурацию base_url, что идеально подходит для подключения через APIYI.
Преимущества:
- Нативная поддержка кастомного
base_url, можно напрямую указывать адрес APIYI. - Поддерживает различные рабочие процессы, такие как текст-в-изображение, изображение-в-изображение, многораундовый диалог и т.д.
- Активно поддерживается, быстро реагирует на отзывы сообщества, функционал постоянно обновляется.
- Использует переменные окружения для настройки API-ключа, что позволяет избежать жёсткого кодирования, безопасно и удобно.
- Поддерживает настройку продвинутых параметров, таких как
temperature,aspect_ratioи т.д.
GitHub репозиторий: github.com/if-ai/ComfyUI-IF_Gemini
Подходит для: Пользователей, которым требуется глубокое использование функций генерации изображений Gemini, желающих настраивать больше параметров и создавать сложные рабочие процессы.
Вариант B: comfyui-gemini-nodes (OpenAI-совместимый режим)
comfyui-gemini-nodes разработан jqy-yo и поддерживает подключение через OpenAI-совместимый режим, что удобно для пользователей с опытом работы с интерфейсами OpenAI.
Преимущества:
- OpenAI-совместимый интерфейс, пользователи с опытом работы с OpenAI не имеют затрат на обучение.
- Поддерживает кастомную настройку трёх параметров:
base_url+api_key+model. - Легковесная реализация, мало зависимостей для установки, низкая вероятность конфликтов окружения.
- Параметры вводятся прямо в интерфейсе узла, принцип WYSIWYG.
GitHub репозиторий: github.com/jqy-yo/comfyui-gemini-nodes
Подходит для: Новичков в ComfyUI, желающих быстро начать работу и проверить эффект, а также разработчиков с опытом использования интерфейсов OpenAI.
Сравнение плагинов Nano Banana 2 для ComfyUI
| Критерий сравнения | ComfyUI-IF_Gemini | comfyui-gemini-nodes |
|---|---|---|
| Способ подключения | Нативный Gemini API | OpenAI-совместимый режим |
| Поддержка base_url | ✅ Настройка через переменные окружения | ✅ Настройка через параметры узла |
| Сложность установки | Средняя | Простая |
| Богатство функций | Высокое (многораундовый диалог и т.д.) | Среднее |
| Активность поддержки | Активная | Активная |
| Рекомендуемый сценарий | Глубокое использование | Быстрый старт |
💡 Технический совет: Если вы новичок в ComfyUI, рекомендуем сначала использовать Вариант B для быстрого старта; если вам нужен более богатый функционал, рекомендуем Вариант A. Оба варианта могут быть подключены через единый интерфейс APIYI apiyi.com для всей серии моделей Gemini.
Nano Banana 2 ComfyUI: Быстрый старт
Вариант A: Установка и настройка ComfyUI-IF_Gemini
Шаг 1: Установка плагина
# Переходим в директорию пользовательских узлов ComfyUI
cd ComfyUI/custom_nodes
# Клонируем репозиторий плагина
git clone https://github.com/if-ai/ComfyUI-IF_Gemini.git
# Устанавливаем зависимости
cd ComfyUI-IF_Gemini
pip install -r requirements.txt
Шаг 2: Настройка API (ключевой шаг)
В корневой директории ComfyUI создайте или отредактируйте файл .env:
# Единая конфигурация интерфейса APIYI
GEMINI_BASE_URL=https://vip.apiyi.com/v1
GEMINI_API_KEY=your_apiyi_api_key_here
🚀 Быстрый старт: Зарегистрируйтесь на APIYI apiyi.com, чтобы получить API-ключ, который поддерживает унифицированный вызов всей серии моделей генерации изображений Gemini.
Шаг 3: Выбор модели для генерации изображений
После перезапуска ComfyUI найдите узел IF_Gemini на панели узлов и установите параметры модели:
model: gemini-3.1-flash-image-preview
Для переключения на другие модели достаточно изменить этот параметр:
# Nano Banana 2 - Качество Pro, максимальная скорость
model: gemini-3.1-flash-image-preview
# Nano Banana Pro - Максимальное качество
model: gemini-3-pro-image-preview
# Nano Banana - Оптимальное соотношение цена/качество
model: gemini-2.5-flash-image
Вариант B: Установка и настройка comfyui-gemini-nodes
Шаг 1: Установка плагина
cd ComfyUI/custom_nodes
git clone https://github.com/jqy-yo/comfyui-gemini-nodes.git
cd comfyui-gemini-nodes
pip install -r requirements.txt
Шаг 2: Настройка API в узле
Перезапустите ComfyUI, добавьте узел Gemini, затем настройте его свойства:
base_url: https://vip.apiyi.com/v1
api_key: your_apiyi_api_key_here
model: gemini-3.1-flash-image-preview
Шаг 3: Запуск рабочего процесса
Подключите узел ввода текста Prompt, нажмите Queue Prompt, и изображение будет сгенерировано.

Полный пример кода Nano Banana 2 ComfyUI
Минималистичный пример вызова Python
Если вы хотите проверить подключение к API вне ComfyUI, можете использовать следующий код:
import openai
client = openai.OpenAI(
api_key="your_apiyi_api_key",
base_url="https://vip.apiyi.com/v1" # Единый интерфейс APIYI
)
response = client.chat.completions.create(
model="gemini-3.1-flash-image-preview",
messages=[
{
"role": "user",
"content": "Generate a beautiful sunset landscape painting"
}
]
)
print(response.choices[0].message.content)
Посмотреть полный JSON конфигурации рабочего процесса
Ниже приведена базовая конфигурация рабочего процесса ComfyUI-IF_Gemini:
{
"nodes": [
{
"type": "IF_GeminiGenerateImage",
"properties": {
"model": "gemini-3.1-flash-image-preview",
"prompt": "A beautiful sunset over mountains, oil painting style",
"aspect_ratio": "16:9",
"temperature": 0.8
}
}
],
"env": {
"GEMINI_BASE_URL": "https://vip.apiyi.com/v1",
"GEMINI_API_KEY": "your_apiyi_api_key"
}
}
Примечание: Фактические свойства узлов могут немного отличаться в зависимости от версии плагина. Пожалуйста, обратитесь к документации плагина для получения актуальных параметров.
Совет: Получите бесплатный тестовый лимит на APIYI apiyi.com, сначала проверьте подключение к API, а затем приступайте к созданию сложных рабочих процессов.
Типы рабочих процессов Nano Banana 2 ComfyUI
Рабочий процесс текст-в-изображение (Text-to-Image)
Самый базовый и часто используемый рабочий процесс: генерация изображения по текстовому описанию:
[Текстовый промпт] → [Узел Gemini] → [Предпросмотр/Сохранение изображения]
Рекомендации по параметрам:
- model:
gemini-3.1-flash-image-preview - Соотношение сторон: выберите одно из 14 доступных в соответствии с вашими потребностями (1:1, 16:9, 9:16, 4:3, 3:4 и т.д.)
- temperature: 0.7-0.9 (чем выше, тем креативнее; чем ниже, тем стабильнее)
Советы по написанию промптов:
- Использование английских промптов обычно дает лучшие результаты.
- Рекомендуемый порядок описания: Субъект → Окружение → Стиль → Освещение → Детали
- Пример: "A cute cat sitting on a windowsill, soft morning light, watercolor style, detailed fur texture"
Рабочий процесс редактирования изображение-в-изображение (Image-to-Image)
Загрузите изображение и отредактируйте его с помощью текстовых инструкций:
[Загрузить изображение] + [Промпт для редактирования] → [Узел Gemini] → [Отредактированное изображение]
Типичные инструкции для редактирования:
- "Изменить фон на ночное звездное небо"
- "Добавить персонажу шляпу"
- "Преобразовать фотографию в акварельный стиль"
- "Удалить текстовый водяной знак с изображения"
- "Изменить дневную сцену на сумерки"
Ключевые моменты использования: Возможности Nano Banana 2 по преобразованию изображение-в-изображение очень сильны. Модель может понимать содержимое изображения и точно выполнять инструкции по редактированию. Рекомендуется делать инструкции по редактированию максимально конкретными, избегая расплывчатых описаний.
Рабочий процесс переноса стиля (Style Transfer)
Примените стиль одного изображения к другому, чтобы создать креативную комбинацию:
[Эталонное изображение стиля] + [Изображение контента] + [Промпт] → [Узел Gemini] → [Стилизованное изображение]
Распространенные сценарии переноса стиля:
- Преобразование фотографий в художественные стили, такие как масляная живопись, акварель, эскиз и т.д.
- Преобразование изображений продуктов в визуальный стиль конкретного бренда
- Преобразование обычных фотографий в стиль аниме или иллюстрации
Рабочий процесс многоходового диалога (Multi-turn)
Nano Banana 2 поддерживает многоходовую генерацию и редактирование изображений в диалоговом режиме, что является уникальной возможностью, отсутствующей у традиционных моделей Stable Diffusion:
Раунд 1: [Промпт: Нарисуй кошку] → [Сгенерировать изображение кошки]
Раунд 2: [Изображение из предыдущего раунда + Промпт: Надень на кошку красный шарф] → [Отредактированное изображение]
Раунд 3: [Изображение из предыдущего раунда + Промпт: Замени фон на снежный пейзаж] → [Финальное изображение]
Преимущества: Постепенное улучшение изображения через многоходовые итерации обеспечивает более контролируемый результат по сравнению с одноразовым сложным промптом.
Рекомендуемые конфигурации рабочих процессов Nano Banana 2 ComfyUI
| Тип рабочего процесса | Рекомендуемая модель | Рекомендуемое соотношение сторон | Ориентировочное время |
|---|---|---|---|
| Текст-в-изображение (повседневное) | NB2 | 1:1 / 16:9 | 3-5 сек |
| Текст-в-изображение (высокое качество) | NB Pro | 1:1 / 4:3 | 8-15 сек |
| Редактирование изображение-в-изображение | NB2 | Как у исходного изображения | 3-6 сек |
| Перенос стиля | NB2 | Как у исходного изображения | 4-7 сек |
| Пакетная генерация | NB | 1:1 | 2-4 сек |
💰 Оптимизация затрат: Для повседневного творчества рекомендуется использовать Nano Banana 2. Вызов через APIYI apiyi.com стоит всего $0.03 за раз, что обеспечивает баланс между качеством изображения и стоимостью. Для сценариев пакетной генерации можно переключиться на Nano Banana ($0.025 за раз), чтобы еще больше снизить затраты.
Nano Banana 2 ComfyUI: Советы по переключению моделей
Основной метод переключения в один клик
Все модели серии вызываются через единый интерфейс APIYI (apiyi.com). Для переключения модели достаточно изменить всего один параметр:
# Метод: меняем только параметр model, остальное без изменений
# Nano Banana 2 - повседневный выбор
model = "gemini-3.1-flash-image-preview"
# Nano Banana Pro - для максимального качества изображения
model = "gemini-3-pro-image-preview"
# Nano Banana - для оптимальной стоимости
model = "gemini-2.5-flash-image"
В узле ComfyUI вам нужно просто выбрать соответствующее имя модели в выпадающем списке или текстовом поле model. base_url и API-ключ совершенно не нужно менять.
Процесс принятия решения по переключению моделей
Выбирайте модель в соответствии с вашими творческими потребностями:
Нужно максимальное качество изображения? → NB Pro (gemini-3-pro-image-preview)
↓ Нет
Нужно 4K + высокая скорость? → NB2 (gemini-3.1-flash-image-preview)
↓ Нет
Стремитесь к минимальной стоимости? → NB (gemini-2.5-flash-image)

Другие плагины Nano Banana 2 ComfyUI
Помимо двух рекомендованных решений, в сообществе есть и другие плагины, которые могут быть полезны:
| Название плагина | Особенности | Поддержка base_url | Сценарии использования |
|---|---|---|---|
| ComfyUI-NanoBanano | Разработан специально для серии Nano Banana | ⚠️ Частично | Быстрое знакомство |
| comfy_nanobanana | Легковесная реализация | ⚠️ Частично | Простые рабочие процессы |
| ComfyUI_Nano_Banana | Версия, поддерживаемая сообществом | ⚠️ Частично | Для специфических функциональных требований |
| ComfyUI Partner Node (официальный) | Официальный партнерский узел Google | ❌ Не поддерживается | Поддерживает только официальный API |
Примечание: Официальный Partner Node ComfyUI не поддерживает подключение сторонних API. Если вам нужно использовать APIYI, выберите решение A или решение B. Поддержка base_url в других плагинах сообщества может варьироваться в зависимости от версии; перед использованием ознакомьтесь с документацией в соответствующем репозитории GitHub.
Особенности установки плагинов Nano Banana 2 ComfyUI
При установке пользовательских узлов ComfyUI обратите внимание на следующие распространенные проблемы:
- Среда Python: Убедитесь, что вы используете среду Python, поставляемую с ComfyUI, для установки зависимостей, чтобы избежать путаницы между системным Python и Python ComfyUI.
- Конфликты зависимостей: При установке нескольких плагинов, связанных с Gemini, могут возникнуть конфликты версий зависимостей; рекомендуется оставить только один.
- Обновление плагинов: Регулярно обновляйте код плагина с помощью
git pull, чтобы получать новейшие функции и исправления. - Устранение неполадок по логам: При возникновении проблем проверяйте вывод консоли ComfyUI; обычно там содержится четкая информация об ошибках.
# Обновление плагина до последней версии
cd ComfyUI/custom_nodes/ComfyUI-IF_Gemini
git pull
pip install -r requirements.txt
Часто задаваемые вопросы
В1: Что делать, если после настройки Nano Banana 2 в ComfyUI появляется сообщение о недействительном API-ключе?
Пожалуйста, проверьте следующие пункты:
- Убедитесь, что API-ключ верен: Войдите в панель управления APIYI на apiyi.com и скопируйте полный API-ключ.
- Проверьте
base_url: Убедитесь, что он установлен какhttps://vip.apiyi.com/v1, обратите внимание на/v1в конце. - Переменные окружения должны быть активны: Если вы используете файл
.env, необходимо перезапустить ComfyUI, чтобы он загрузился. - Разрешения ключа: Убедитесь, что ваш API-ключ имеет разрешение на вызов моделей генерации изображений.
Ключ, полученный через APIYI на apiyi.com, по умолчанию поддерживает всю серию моделей Gemini. В случае возникновения проблем, пожалуйста, свяжитесь со службой поддержки для их устранения.
В2: Что делать, если Nano Banana 2 генерирует изображения в ComfyUI очень медленно или происходит тайм-аут?
Скорость генерации зависит от нескольких факторов:
- Сетевое окружение: Использование
base_urlот APIYI (apiyi.com) может оптимизировать сетевой путь, обычно это стабильнее, чем прямое подключение к официальному API. - Выбор разрешения: Разрешение 4K требует больше времени, чем 2K. Для повседневного тестирования рекомендуется сначала использовать низкое разрешение.
- Выбор модели: NB2 — самая быстрая (3-5 секунд), NB Pro — медленнее (8-15 секунд).
- Настройки тайм-аута: В конфигурации плагина установите время тайм-аута более 60 секунд.
В3: Как реализовать автоматическое переключение между несколькими моделями в ComfyUI?
Вы можете использовать условные узлы ComfyUI для автоматического переключения:
- Создайте текстовый узел «Выбор модели» и введите название модели.
- Подключите этот узел к входу
modelузла Gemini. - Переключайтесь с помощью выпадающего списка или текстового ввода:
gemini-3.1-flash-image-preview,gemini-3-pro-image-preview,gemini-2.5-flash-image.
Все модели используют один и тот же base_url APIYI и API-ключ. Переключение моделей не требует повторной настройки.
В4: Поддерживает ли бесплатный уровень Google официальную генерацию изображений Nano Banana 2?
Не поддерживает. Бесплатный уровень (Free Tier) Google AI Studio не поддерживает функцию генерации изображений и вернет ошибку при вызове. Чтобы использовать функцию генерации изображений Gemini, вам необходимо:
- Использовать платный API Google Cloud (требуется кредитная карта и зарубежный аккаунт).
- Или вызывать через платформу APIYI (apiyi.com), без необходимости в зарубежной кредитной карте, с более гибкой оплатой за вызов.
В5: Что делать, если генерация изображений Nano Banana 2 завершается неудачей из-за фильтра безопасности?
Gemini 3.1 Flash Image имеет встроенный механизм фильтрации безопасности. Следующие промпты могут вызвать срабатывание фильтра:
- Связанные с людьми: Описания, касающиеся реальных людей или знаменитостей.
- Чувствительный контент: Описания насилия, крови и т.п.
- Связанные с авторским правом: Точные описания известных персонажей интеллектуальной собственности.
Решение: Измените промпт, используя более абстрактные и общие описания. Если вы часто сталкиваетесь с фильтрацией безопасности, рекомендуем ознакомиться с нашей статьей, подробно описывающей механизм безопасности Nano Banana 2.
Итоги подключения Nano Banana 2 к ComfyUI
Основные шаги по подключению Nano Banana 2 к ComfyUI очень просты: установка плагина → настройка API → выбор модели.
Ключевые моменты
| Шаг | Действие | Время |
|---|---|---|
| Установка плагина | git clone + pip install | 2 минуты |
| Настройка API | Установка base_url + API-ключа | 1 минута |
| Выбор модели | Ввод названия модели | 30 секунд |
| Тестовый запуск | Queue Prompt для генерации изображения | 1 минута |
Основные выводы
- Выбор подходящего плагина: Рекомендуем ComfyUI-IF_Gemini (многофункциональный) или comfyui-gemini-nodes (быстрый старт).
- Настройка единого интерфейса APIYI: Установите
base_urlкакhttps://vip.apiyi.com/v1. Однократная настройка позволит использовать всю серию моделей. - Гибкое переключение моделей: NB2 ($0.03), NB Pro ($0.05), NB ($0.025) — достаточно изменить параметр
model. - Разнообразные рабочие процессы: текст-в-изображение, изображение-в-изображение, перенос стиля, многораундовый диалог — для удовлетворения различных творческих потребностей.
- Эксклюзивная функция: Уникальная функция Grounding для поиска изображений в NB2 открывает больше возможностей для творчества.
Рекомендуем быстро получить API-ключ через APIYI (apiyi.com). Всего за 5 минут вы сможете испытать качество Pro-уровня и сверхбыструю генерацию Nano Banana 2 в ComfyUI. Единый интерфейс для всей серии моделей позволяет переключаться по мере необходимости.
Автор: Команда APIYI | Техническая поддержка: APIYI apiyi.com
Эта статья основана на тестировании с использованием последней версии ComfyUI и платформы APIYI. В случае обновления плагина, пожалуйста, обратитесь к документации соответствующего репозитория GitHub.
