GPT Image 2.5 подключается к ComfyUI через официальный OpenAI GPT Image 2.5 Partner Node. Это удалённая генерация: файл весов для локального запуска скачивать не нужно. В руководстве ComfyUI указана версия ComfyUI 0.35.0 или новее, модели Flare и Sunburst и готовые шаблоны для генерации и редактирования.
Самая короткая схема — узел GPT Image 2.5 с текстовым описанием, соединённый с Save Image. Для запуска нужны вход в аккаунт Comfy и положительный баланс кредитов. Ключ OpenAI в этом официальном узле не заменяет авторизацию Comfy. Ниже разбираем именно этот способ подключения по документации и исходному коду, проверенным 21 сентября 2026 года; оплачиваемые генерации для статьи не запускались.
Сначала настройте доступ, затем собирайте схему
Обновите ComfyUI до версии, поддерживающей GPT Image 2.5, и перезапустите приложение. Откройте библиотеку шаблонов и найдите GPT Image 2.5. Официальная инструкция предлагает четыре шаблона для генерации и правок. Если шаблона пока нет в вашей сборке, проверьте обновление ядра и шаблонов: изменения могут сначала появиться в nightly, а затем в стабильном выпуске. Отсутствие узла не означает, что нужно устанавливать случайный набор custom nodes.
В Settings → User выполните вход в Comfy, а в Settings → Credits проверьте баланс. Для Partner Nodes требуется баланс больше нуля. При открытии ComfyUI на том же компьютере предусмотрен обычный вход; для адреса в локальной сети или другого неподдерживаемого адреса документация описывает ComfyUI Account API Key. Условия подключения приведены в обзоре Partner Nodes.
Различие между учётными данными влияет и на оплату:
| Учётные данные | К какому подключению относятся |
|---|---|
| Аккаунт Comfy и его кредиты | Официальные Partner Nodes в ComfyUI |
| ComfyUI Account API Key | Авторизация аккаунта Comfy в описанных документацией условиях |
| OpenAI API key | Прямые запросы к OpenAI API |
| Ключ стороннего API-провайдера | Запросы к адресу и моделям этого провайдера |
| Подписка ChatGPT | Работа в ChatGPT; не замена перечисленным API-расчётам |
Не путайте ключ аккаунта Comfy с ключом публикации в реестре узлов. Не вставляйте ключ посредника в поле для учётных данных Comfy. Русский язык статьи также не означает, что любой из этих сервисов доступен в стране читателя: условия аккаунта и доступность нужно проверять у выбранного сервиса.
Первая генерация: два узла и понятный результат
В официальном шаблоне найдите OpenAI GPT Image 2.5. В исходном коде его идентификатор — OpenAIGPTImageNodeV2; это удобно для диагностики, если редактор сообщает о неизвестном типе узла при загрузке схемы.
Для первого запуска задайте gpt-image-2.5-flare, качество medium, квадратный размер 1024 × 1024 и одно изображение. Введите конкретное описание, например: «Предметная фотография матового синего чайника на светлом столе, рассеянный дневной свет, без надписей». Соедините выход изображения с Save Image и запустите очередь. Успех проверяется по полученному изображению и сохранённому файлу, а не по тому, что задание появилось в очереди.
Это исходные настройки для проверки подключения, не обещание определённой цены или времени ответа. Flare предназначена для быстрой генерации, Sunburst — для более точных правок; обе поддерживают создание и редактирование. Смотрите страницы Flare и Sunburst. Выбор по требованиям к результату разобран в сравнении двух моделей.
В проверенной реализации у узла доступны low, medium, high, xhigh и max; количество изображений n — от 1 до 8. Не переносите все значения из документации прямого API в список ComfyUI: интерфейс конкретного узла может предоставлять другой набор настроек. Актуальная реализация находится в nodes_openai.py.
Референс включает редактирование, маска ограничивает область правки
Без подключённых изображений узел выполняет генерацию. С референсами он использует операцию редактирования. Поэтому изображение нужно подать на соответствующий вход: упоминание локального имени файла в текстовом описании не загружает его в API.
Для простой правки добавьте Load Image, загрузите исходник и подключите его к входу изображения GPT Image 2.5. В описании отдельно сформулируйте изменение и то, что требуется сохранить: «Замените серый фон на светлую кухню. Сохраните форму, цвет и положение чайника». Начните с одного результата и проверьте его, прежде чем заказывать серию.
Маска в этом узле поддерживается только при одном исходном изображении. В ComfyUI белая область маски отмечает участок для изменения. Если нужно заменить фон, белым выделяют фон, а сам объект оставляют вне этой области. Подключите выход маски к входу mask узла GPT Image 2.5.
В прямом Images API встречается другое описание: редактируемый участок обозначается прозрачностью маски. Это не противоречие интерфейсов. В коде узла ComfyUI маска преобразуется по правилу alpha = 1 - mask перед отправкой. При работе в ComfyUI ориентируйтесь на его белую область, не инвертируйте маску только из-за формулировки в инструкции по прямому API.
Маска задаёт область желаемой правки, но не гарантирует сохранение всех остальных пикселей. Для товара отдельно проверьте силуэт, текст и мелкие элементы. Сохраните исходник, маску и готовый файл: так можно оценивать изменение по конкретным материалам, а не по памяти.
Для задач без маски разрешено до 16 референсов. Это не означает, что 16 изображений всегда нужны или что их роли будут понятны без объяснения. В описании укажите, какое изображение задаёт объект, а какое — окружение или стиль. Проверенная реализация уменьшает референсы до площади не более 2048 × 2048 пикселей перед отправкой; не рассчитывайте, что мелкая надпись огромного исходника обязательно попадёт в запрос в исходном разрешении.
Размер: поля ширины и высоты проверяются вместе
Начать проще с готового пресета. Для своего размера недостаточно, чтобы число принималось в поле: пара ширина–высота должна одновременно выполнять ограничения текущего узла.
- Обе стороны кратны 16.
- Длинная сторона не превышает 3840 пикселей.
- Соотношение сторон не превышает 3:1.
- Площадь находится в диапазоне от 655 360 до 8 294 400 пикселей.
- В интерфейсе минимальное значение стороны — 480 пикселей.
Эти условия взяты из проверок официального узла, а не из измерения сгенерированных файлов.
| Пример размера | Проверка ограничений |
|---|---|
| 1024 × 1024 | Подходит: 1 048 576 пикселей, квадрат |
| 3840 × 2160 | Подходит: 8 294 400 пикселей, верхняя граница площади |
| 3840 × 3840 | Не подходит: 14 745 600 пикселей, площадь выше максимума |
| 480 × 480 | Не подходит: 230 400 пикселей, площадь ниже минимума |
Таким образом, слово «4K» само по себе не описывает допустимый размер. Для горизонтального изображения 3840 × 2160 условия выполняются, для квадрата с такой же стороной — нет.
Что означает seed и где выполняется работа
Узел показывает seed, однако его описание в проверенном исходном коде прямо говорит, что серверная часть пока его не реализует. Одинаковое значение seed не обещает одинаковое изображение. Для сравнения вариантов сохраняйте текст, модель, качество, размер, референсы и результат; не называйте такую пару запусков воспроизводимым тестом только из-за совпадающего числа.
Генерация GPT Image 2.5 выполняется удалённо. Поэтому инструкции по скачиванию checkpoint и требования к видеопамяти для SDXL или Flux не являются требованиями самой GPT Image 2.5. При этом локальные узлы вашей схемы — увеличение разрешения, сегментация, обработка большого изображения — могут использовать местную память и GPU. Требования ко всей схеме определяются этими узлами тоже.
Проблемы подключения полезно разделять по этапам:
| Симптом | Что проверить первым |
|---|---|
| Неизвестный узел при открытии шаблона | Версию ComfyUI, обновление ядра и шаблонов |
| Требуется вход или недостаточно средств | Аккаунт Comfy и Credits, а не баланс OpenAI |
| Ошибка размера | Кратность, стороны, соотношение и общую площадь |
| Маска не принимается | Ровно один референс и правильное подключение mask |
| Повтор с тем же seed дал другую картинку | Отсутствие поддержки seed на сервере |
| Изображение получено, но файла нет | Соединение с Save Image и результат сохранения |
Можно ли подключить свой адрес API или запускать схему из n8n?
У официального Partner Node в проверенном коде нет общедоступного поля для произвольного base URL: запросы идут через прокси Comfy с его авторизацией. Поэтому обещать подключение любого совместимого провайдера простой заменой ключа нельзя. Для стороннего узла нужно отдельно проверить документацию, способ хранения ключа, поддерживаемые модели и параметры.
Схему ComfyUI можно использовать как часть автоматизации, но старый пример вызова локального SDXL из n8n не подтверждает работу Partner Node. Потребуются корректная авторизация Comfy в выбранном способе запуска, отслеживание очереди и получение сохранённого результата. Простая пауза после отправки задания не доказывает завершение генерации.
Если задача ограничивается получением одной картинки по описанию, оценивайте, нужны ли вам вообще локальные узлы ComfyUI. Его преимущество в таком сценарии появляется, когда референсы, маски и дальнейшая обработка должны жить в одной наглядной схеме. Первую проверку завершайте сохранённым файлом; только после неё расширяйте схему и количество результатов.
