Обзор
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 文生图提示词控制器(контроллер промптов для преобразования текста в изображение) /图生图提示词控制器(контроллер промптов для преобразования изображения в изображение) /文本停留编辑器(редактор пауз в тексте). Они используют мультимодальную модель, чтобы преобразовать ваше описание в структурированный промпт для создания изображения, и позволяют приостанавливать рабочий процесс для ручного редактирования
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 репозитория
Основные возможности
Три узла, три маршрута
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 на официальном узле точно определяет область редактирования (прозрачная область перерисовывается, непрозрачная сохраняется)Реальное разрешение и пользовательский размер
Контроллеры промптов
gemini-3.5-flash преобразует текстовое описание или до 5 эталонных изображений в структурированный промпт для изображения с возможностью приостановки для ручного редактированияВстроенные тайм-аут и повторные попытки
408 / 429 / 5xx выполняют повторные попытки согласно retry_times, поэтому задержки в часы пик обрабатываются автоматическиПоддерживаемые модели APIYI
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 и наличия подключённых эталонных изображений.
- Без незаметного понижения уровня: выбор
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, плюс два элемента управления размером:
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: Клонируйте в custom_nodes
git pull в этой папке для получения поддержки 2.5.Шаг 2: Установите зависимости
Шаг 3: Полностью перезапустите ComfyUI
Comfyui-Luck в палитре узлов, чтобы найти три узла изображений и три узла prompt. Простого обновления интерфейса недостаточно; перезапустите процесс после обновления плагина.Шаг 4: Настройте ключ и домен APIYI
- Перейдите в Консоль APIYI → Tokens, создайте ключ (рекомендуется установить лимит использования)
- Вставьте его в поле
api_keyузла - Выберите один
api_base:https://api.apiyi.com/v1(основной) /https://b.apiyi.com/v1(резервный для материкового Китая). Узел принимает базовый URL как с/v1, так и без него
Шаг 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
Примеры использования
Пример 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
Переключатся ли существующие рабочие процессы на 2.5 после обновления плагина?
Переключатся ли существующие рабочие процессы на 2.5 после обновления плагина?
gpt-image-2 не изменились, поэтому старый рабочий процесс продолжит выполнять gpt-image-2 с исходным качеством. Чтобы перейти на 2.5, вручную переключите выпадающий список model (模型) и выберите заново quality, сверяясь с таблицей выше.Почему после переключения на 2.5 с тем же значением high результат дешевле и более размытый?
Почему после переключения на 2.5 с тем же значением high результат дешевле и более размытый?
high выдает примерно четверть от объема tokens модели gpt-image-2 high, что соответствует прежнему уровню medium; чтобы получить бюджет старого high на 2.5, выберите max. И наоборот, при том же бюджете в 2.5 добавлены high / xhigh в качестве двух более дешевых промежуточных уровней. Протестируйте свои prompt по одному разу на каждый уровень и сравните usage.output_tokens перед запуском в продакшн.Поддерживает ли плагин gpt-image-2.5-all / gpt-image-2.5-vip?
Поддерживает ли плагин gpt-image-2.5-all / gpt-image-2.5-vip?
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 напрямую.Узел не найден после установки?
Узел не найден после установки?
- Убедитесь, что папка находится по пути
ComfyUI/custom_nodes/Comfyui-Luck-gpt2.0 - Команда
pip install -r requirements.txtвыполнена без ошибок - Полностью перезапустите ComfyUI (простого обновления интерфейса в браузере недостаточно)
Частые тайм-ауты при 4K, xhigh / max или произвольных размерах?
Частые тайм-ауты при 4K, xhigh / max или произвольных размерах?
- В официальном узле по умолчанию установлен тайм-аут чтения 600 секунд; сохраните или увеличьте его для 2.5
xhigh/maxи 2K / 4K. Ошибка408 Timeoutобычно означает, что истек тайм-аут задачи генерации на стороне провайдера, а не неверный параметр узла - Синхронный запрос может быть тарифицирован даже после истечения тайм-аута у клиента, а автоматические повторные попытки приводят к лишним расходам; установите
retry_timesна1, чтобы отключить повторы - Если сетевое соединение вашего сервера медленное, см. Медленная загрузка изображений/видео через CDN
- Переключите
api_baseнаb.apiyi.com/v1, если домен по умолчанию работает нестабильно
При загрузке старого рабочего процесса возникает ошибка Value 3 smaller than min of 30?
При загрузке старого рабочего процесса возникает ошибка Value 3 smaller than min of 30?
retry_times=3 было считано как timeout_seconds=3. Используйте актуальный example_workflow.json из репозитория либо удалите и добавьте узел заново.После подключения редактора пауз gpt-image-2 выдает Value not in list?
После подключения редактора пауз gpt-image-2 выдает Value not in list?
prompt во входной сокет оставляет старый рабочий процесс без одного плейсхолдера prompt, из-за чего виджеты после него сдвигаются на один шаг (например, mode считывает gpt-image-2, api_base считывает 2K). Актуальный узел проходит валидацию и восстанавливает смещенные значения во время выполнения; если на панели они по-прежнему отображаются со сдвигом, перезагрузите текущий рабочий процесс или добавьте Comfyui-Luck gpt-image-2 заново.b64_json из reverse-узлов возвращается с префиксом?
b64_json из reverse-узлов возвращается с префиксом?
gpt-image-2-all / gpt-image-2-vip возвращают b64_json с префиксом data:image/png;base64,, тогда как официальная линейка gpt-image-2 — без него. Все три узла автоматически декодируют оба формата, поэтому подключайте вывод напрямую к PreviewImage. Подробности см. в сравнении официального и reverse-вариантов.Вызовы возвращают 401 / 403?
Вызовы возвращают 401 / 403?
- Проверьте валидность
api_keyи наличие ограничений по группе - Убедитесь, что выбранная модель добавлена в белый список для token
- Вопросы по балансу: см. раздел Баланса кажется достаточно, но вызовы завершаются ошибкой