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

Обзор

Comfyui-Luck-gpt2.0 — это набор пользовательских узлов ComfyUI, созданный участником сообщества luckdvr. Он вызывает модели изображений GPT от APIYI непосредственно в ComfyUI. Сейчас в набор входят три узла для работы с изображениями и три узла управления промптами:
  • Comfyui-Luck gpt-image-2 (официальный): в выпадающем списке моделей доступны gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst; узел отправляет настоящие size / quality, поддерживает дорисовку по маске и до 16 референсных изображений
  • Comfyui-Luck gpt-2.0 all (обратный): вызывает gpt-image-2-all; тарификация за вызов, высокая скорость, диалоговое редактирование
  • Comfyui-Luck gpt-image-2-vip (обратный): вызывает gpt-image-2-vip; тарификация за вызов, маршрут Adobe
  • Узлы управления промптами: GPT-Image-2 文生图提示词控制器 (контроллер промптов для преобразования текста в изображение) / 图生图提示词控制器 (контроллер промптов для преобразования изображения в изображение) / 文本停留编辑器 (редактор пауз в тексте). Они используют мультимодальную модель, чтобы преобразовать ваше описание в структурированный промпт для создания изображения, и позволяют приостанавливать рабочий процесс для ручного редактирования
Обновление от 2026-09-10: добавлена поддержка GPT-Image 2.5. В официальном узле появились gpt-image-2.5-flare (приоритет скорости) и gpt-image-2.5-sunburst (приоритет качества и точности редактирования), а quality теперь включает шесть уровней (добавлены xhigh / max). Имена узлов, идентификаторы, порядок виджетов и модель по умолчанию gpt-image-2 не изменились, поэтому в существующих рабочих процессах модель или качество не изменятся автоматически. После обновления плагина выберите модель в выпадающем списке model (模型). См. раздел «Использование GPT-Image 2.5 в узле» ниже.
Информация о проекте
  • 🔗 Источник: github.com/luckdvr/Comfyui-Luck-gpt2.0
  • 📜 Лицензия: Apache-2.0
  • 👤 Автор: luckdvr
  • ⭐ Вклад сообщества, созданный для APIYI. Сначала сообщайте об изменениях в работе API или ошибках узлов в разделе Issues репозитория
Как отличить этот набор от другого набора узлов автора?luckdvr создал два набора узлов ComfyUI для APIYI:
  • Luck Nano Banana Pro: вызывает линейку Gemini (gemini-3-pro-image / gemini-3.1-flash-image), делает акцент на 14 референсных изображениях и устойчивой обработке повторных попыток и тайм-аутов
  • Luck GPT-Image 2 (эта страница): вызывает линейку OpenAI (gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2-all / gpt-image-2-vip), делает акцент на управлении настоящими size / quality, дорисовке по маске и контроллерах промптов

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

Три узла, три маршрута

Официальный gpt-image-2, обратный gpt-2.0 all и обратный gpt-image-2-vip — каждый для своего маршрута. Выбирайте вариант с учётом бюджета и задач

Парные модели GPT-Image 2.5

Переключите официальный узел на gpt-image-2.5-flare / gpt-image-2.5-sunburst; также доступны -2026-09-08 снапшоты с датами для фиксации версии

Шесть уровней качества

quality принимает значения auto / low / medium / high / xhigh / max; xhigh / max поддерживаются только двумя моделями 2.5

До 16 эталонных изображений

Официальный узел принимает image_01 … image_16; два обратных узла принимают до 14 изображений для объединения нескольких изображений и переноса стиля

Дорисовка по маске

Необязательный вход mask на официальном узле точно определяет область редактирования (прозрачная область перерисовывается, непрозрачная сохраняется)

Реальное разрешение и пользовательский размер

Предустановки auto / 1K / 2K / 4K и пользовательский размер (максимум 3840 пикселей по каждой стороне, от 655,360 до 8,294,400 пикселей всего)

Контроллеры промптов

По умолчанию gemini-3.5-flash преобразует текстовое описание или до 5 эталонных изображений в структурированный промпт для изображения с возможностью приостановки для ручного редактирования

Встроенные тайм-аут и повторные попытки

Для официального узла по умолчанию установлен тайм-аут 600 секунд; 408 / 429 / 5xx выполняют повторные попытки согласно retry_times, поэтому задержки в часы пик обрабатываются автоматически

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

Все три официальные модели имеют одинаковую цену и параметры и тарифицируются за token; реверс-модели тарифицируются за вызов: gpt-image-2-all $0.025 за изображение, gpt-image-2-vip $0.03 за изображение. Полное сравнение официальных и реверс-моделей см. в сравнении официальных и реверс-моделей gpt-image-2.5 / 2.

Использование GPT-Image 2.5 в узле

Обновите плагин, полностью перезапустите ComfyUI, затем переключите раскрывающийся список model (模型) в Comfyui-Luck gpt-image-2. Все остальные виджеты остаются без изменений. Обе модели 2.5 поддерживают преобразование текста в изображение, редактирование изображений, 16 эталонных изображений и маску; узел выбирает эндпоинт генерации или редактирования на основе mode и наличия подключённых эталонных изображений.
Не переносите quality без изменений при переходе с gpt-image-2 на 2.5. Согласно измерениям APIYI выходных token при одинаковом размере, выполненным 2026-09-09, значение high в версии 2.5 соответствует старому medium, а старому high соответствует только значение max в версии 2.5. Это соответствие бюджета token, а не гарантия качества на уровне сопоставления пиксель к пикселю. Чтобы сопоставить бюджет high старой версии в 2.5, выберите max; при том же бюджете high / xhigh в версии 2.5 дают два более дешёвых промежуточных уровня.
Перед созданием рабочего процесса стоит учитывать следующие особенности поведения на уровне узла:
  • Без незаметного понижения уровня: выбор xhigh / max в старой версии gpt-image-2 или недействительной модели / настройки качества приводит к ошибке узла до отправки запроса. Узел никогда не заменяет уровень автоматически
  • Используйте auto экономно: auto — это динамический уровень рассуждения, поэтому стоимость и задержка для одного и того же промпта меняются между уровнями. Чтобы контролировать расходы, выбирайте уровень явно
  • Фиксируйте датированные снимки в рабочей среде: gpt-image-2.5-flare-2026-09-08 / gpt-image-2.5-sunburst-2026-09-08 в раскрывающемся списке фиксируют версию модели, поэтому изменение псевдонима upstream не повлияет на вас
  • Сохраняйте тайм-аут 600 секунд: для xhigh / max версии 2.5, разрешений 2K / 4K или сложного редактирования оставьте значение по умолчанию или увеличьте его. Синхронный запрос всё ещё может тарифицироваться после истечения тайм-аута на стороне клиента, а автоматические повторы могут увеличить стоимость; установите retry_times в 1, если повторы не нужны

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

Comfyui-Luck gpt-image-2 (официальный)

Подписи к элементам управления на панели содержат суффикс на китайском языке, например api_key (API密钥); в таблицах ниже приведены только названия полей на английском языке. Четыре ограничения для custom_size: ни одна из сторон не должна превышать 3840px, ширина и высота кратны 16, соотношение длинной стороны к короткой не более 3:1, общее количество пикселей от 655 360 до 8 294 400. Соотношения сторон 1:4 / 4:1 / 1:8 / 8:1 превышают официальное ограничение 3:1, поэтому узел приводит их к ближайшему допустимому граничному размеру; для 4K + 1:1 используется 2880x2880, а не 3840x3840, поскольку последний превышает ограничение по общему числу пикселей.
Узел не отправляет background / moderation / response_format / input_fidelity; для всех них используются значения по умолчанию API. Для прозрачного фона и аналогичных параметров вызывайте API напрямую (для прозрачности требуются gpt-image-2.5-flare / gpt-image-2.5-sunburst; OpenAI отключила эту возможность для gpt-image-2 2026-09-30), см. FAQ по прозрачному фону.

Comfyui-Luck gpt-2.0 all (обратный)

gpt-image-2-all не принимает поля API size / quality / n / aspect_ratio, и узел никогда их не отправляет; 2K / 4K можно указать только в prompt, без гарантии количества пикселей. Выходные данные url обычно представляют собой временную ссылку CDN, действительную около суток, поэтому при необходимости длительного хранения разместите её на другом хостинге.

Comfyui-Luck gpt-image-2-vip (обратный)

Те же виджеты, что и у gpt-2.0 all, плюс два элемента управления размером:
Автор создал этот узел на основе уведомления APIYI от 2026-06-23 о том, что size был отключён, поэтому по умолчанию он не отправляет size. На стороне APIYI size для gpt-image-2-vip была восстановлена 2026-07-22 (30 распространённых размеров; см. документацию по gpt-image-2-vip); плагин ещё не обновлён. Чтобы сегодня задавать реальные размеры выходных данных внутри ComfyUI, используйте официальный узел Comfyui-Luck gpt-image-2. Обратный b64_json содержит префикс data:image/png;base64,, который узел декодирует автоматически.

Узлы управления промптами

  • Оба контроллера вызывают APIYI POST /v1/chat/completions; в выпадающем списке моделей доступны gemini-3.5-flash / gpt-5.5 / gpt-4o / gpt-4.1-mini / gemini-2.5-flash / gemini-2.5-pro
  • Контроллер преобразования изображения в изображение выполняет только анализ изображений и улучшение промпта. Для полноценного использования нескольких референсных изображений или их объединения подключите те же изображения также к последующему узлу изображений
  • Редактор паузы выводит в edited_text одну строку для prompt узла изображений; edited_texts — это список, предназначенный для пакетных рабочих процессов с текстом. После паузы нажмите Continue на узле. Не нажимайте основную кнопку «Запуск» ещё раз, иначе ComfyUI повторно поставит рабочий процесс в очередь и заново выполнит предшествующее улучшение промпта

Установка

1

Шаг 1: Клонируйте в custom_nodes

В директории установки ComfyUI:
Действующие пользователи могут выполнить git pull в этой папке для получения поддержки 2.5.
2

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

3

Шаг 3: Полностью перезапустите ComfyUI

Выполните поиск Comfyui-Luck в палитре узлов, чтобы найти три узла изображений и три узла prompt. Простого обновления интерфейса недостаточно; перезапустите процесс после обновления плагина.
4

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

  • Перейдите в Консоль APIYI → Tokens, создайте ключ (рекомендуется установить лимит использования)
  • Вставьте его в поле api_key узла
  • Выберите один api_base: https://api.apiyi.com/v1 (основной) / https://b.apiyi.com/v1 (резервный для материкового Китая). Узел принимает базовый URL как с /v1, так и без него
5

Шаг 5: Импортируйте пример рабочего процесса

В репозитории представлены два примера:
  • example_workflow.json: по одному примеру на каждый узел изображений (в официальном используются size=2048x1152 + quality=high + jpeg), с узлами Note на китайском языке, объясняющими, как сделать выбор
  • example_workflow_gpt_image_2_5.json: отдельный пример для 2.5, Flare: текст в изображение → редактирование Sunburst → предпросмотр, со значениями по умолчанию для 1K + 1:1, quality=high, таймаутом 600 секунд и retry_times=1
Ключи API в примерах не указаны; введите свой ключ для запуска. Удалите ключ перед тем, как делиться своим рабочим процессом.

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

Пример 1: Flare 2.5 4K — высококачественная генерация изображений из текста

max — это уровень 2.5 с тем же бюджетом token, что и у старого gpt-image-2 high; сначала попробуйте high или xhigh, если вам нужны более высокая скорость и меньшая стоимость.

Пример 2: Рисование по маске Sunburst 2.5

Пример 3: Цепочка Flare: текст → редактирование Sunburst

Соответствует example_workflow_gpt_image_2_5.json в репозитории:

Пример 4: Обратное диалоговое изображение

Пример 5: Контроллер prompt → приостановка и редактирование → генерация

Поставьте запуск в очередь на финальном PreviewImage / SaveImage. Когда поток остановится в редакторе паузы, измените текст и нажмите Continue на узле. Если одно из изображений представляет собой объект, который необходимо зафиксировать, также подключите его к subject_image контроллера и разместите на image_01 узла изображения.

Часто задаваемые вопросы

  • Comfyui-Luck gpt-image-2 (официальный): настоящие size / quality, нативная маска, до 16 референсов, тарификация за token. Выбирайте его, когда требуются точные размеры, локальное редактирование или шесть уровней качества 2.5; по умолчанию используйте gpt-image-2.5-flare для text-to-image и gpt-image-2.5-sunburst для редактирования
  • Comfyui-Luck gpt-2.0 all (reverse): тарификация за вызов ($0.025 за изображение), около 30–60 с, веб-маршрут ChatGPT. Выбирайте его для итеративного редактирования и качественного рендеринга текста, когда строгий контроль размеров не требуется
  • Comfyui-Luck gpt-image-2-vip (reverse): тарификация за вызов ($0.03 за изображение), около 90–150 с, маршрут Adobe. Второй reverse-маршрут, который стоит держать под рукой; в настоящее время плагин не отправляет size
  • Полное сравнение: официальный против reverse
Нет. Названия узлов, идентификаторы, порядок виджетов и модель по умолчанию gpt-image-2 не изменились, поэтому старый рабочий процесс продолжит выполнять gpt-image-2 с исходным качеством. Чтобы перейти на 2.5, вручную переключите выпадающий список model (模型) и выберите заново quality, сверяясь с таблицей выше.
В версии 2.5 была изменена сетка уровней качества. По замерам APIYI для одинаковых размеров от 2026-09-09, 2.5 high выдает примерно четверть от объема tokens модели gpt-image-2 high, что соответствует прежнему уровню medium; чтобы получить бюджет старого high на 2.5, выберите max. И наоборот, при том же бюджете в 2.5 добавлены high / xhigh в качестве двух более дешевых промежуточных уровней. Протестируйте свои prompt по одному разу на каждый уровень и сравните usage.output_tokens перед запуском в продакшн.
В двух reverse-узлах в настоящее время доступны только gpt-image-2-all и gpt-image-2-vip. Веб-приложение ChatGPT, на котором работает gpt-image-2-all, было обновлено до Images 2.5, поэтому эта модель уже генерирует изображения 2.5, ведет себя так же и стоит столько же, сколько gpt-image-2.5-all; см. документацию gpt-image-2.5-all. Модели gpt-image-2.5-flare-vip / gpt-image-2.5-sunburst-vip пока отсутствуют в выпадающем списке узла; при необходимости вызывайте API напрямую.
  1. Убедитесь, что папка находится по пути ComfyUI/custom_nodes/Comfyui-Luck-gpt2.0
  2. Команда pip install -r requirements.txt выполнена без ошибок
  3. Полностью перезапустите ComfyUI (простого обновления интерфейса в браузере недостаточно)
  • В официальном узле по умолчанию установлен тайм-аут чтения 600 секунд; сохраните или увеличьте его для 2.5 xhigh / max и 2K / 4K. Ошибка 408 Timeout обычно означает, что истек тайм-аут задачи генерации на стороне провайдера, а не неверный параметр узла
  • Синхронный запрос может быть тарифицирован даже после истечения тайм-аута у клиента, а автоматические повторные попытки приводят к лишним расходам; установите retry_times на 1, чтобы отключить повторы
  • Если сетевое соединение вашего сервера медленное, см. Медленная загрузка изображений/видео через CDN
  • Переключите api_base на b.apiyi.com/v1, если домен по умолчанию работает нестабильно
Порядок виджетов в старом рабочем процессе больше не соответствует узлу, поэтому retry_times=3 было считано как timeout_seconds=3. Используйте актуальный example_workflow.json из репозитория либо удалите и добавьте узел заново.
Преобразование prompt во входной сокет оставляет старый рабочий процесс без одного плейсхолдера prompt, из-за чего виджеты после него сдвигаются на один шаг (например, mode считывает gpt-image-2, api_base считывает 2K). Актуальный узел проходит валидацию и восстанавливает смещенные значения во время выполнения; если на панели они по-прежнему отображаются со сдвигом, перезагрузите текущий рабочий процесс или добавьте Comfyui-Luck gpt-image-2 заново.
Reverse gpt-image-2-all / gpt-image-2-vip возвращают b64_json с префиксом data:image/png;base64,, тогда как официальная линейка gpt-image-2 — без него. Все три узла автоматически декодируют оба формата, поэтому подключайте вывод напрямую к PreviewImage. Подробности см. в сравнении официального и reverse-вариантов.
  1. Проверьте валидность api_key и наличие ограничений по группе
  2. Убедитесь, что выбранная модель добавлена в белый список для token
  3. Вопросы по балансу: см. раздел Баланса кажется достаточно, но вызовы завершаются ошибкой

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

Документация gpt-image-2.5 / 2 (официальный релей)

flare / sunburst / gpt-image-2 имеют общие цены и параметры, нативное разрешение 2K/4K, тарификация за tokens

Обзор релиза GPT-image-2.5

Flare быстрее, Sunburst точнее; шесть уровней качества и рекомендации по миграции

Документация gpt-image-2-all (реверс)

Маршрут ChatGPT web, $0.025 за изображение

Документация gpt-image-2-vip (реверс)

Маршрут Adobe, $0.03 за изображение, поддержка 30 размеров

Сравнение официального релея и реверса

Сводная таблица различий между официальным релеем и реверсом

Коллекция нод ComfyUI

Другие ноды ComfyUI, адаптированные APIYI

Luck Nano Banana Pro (от того же автора)

Нода ComfyUI линейки Gemini от luckdvr

APIYI GPT-Image 2 Skills (те же модели)

Вариант AI Agent Skill для моделей генерации изображений GPT

Консоль APIYI

Управление ключами, расходом и группами