GPT Image 2 можно использовать внутри ComfyUI через официальный OpenAI Partner Node, но это не локальный checkpoint и не модель, которая скачивается на вашу видеокарту. ComfyUI остается графом, холстом и средой оркестрации, а сам шаг генерации или редактирования выполняется через удаленный маршрут OpenAI API. Поэтому первый выбор не про красивый workflow, а про владельца маршрута: официальный Partner Node для графа, Image API для прямого backend-вызова, Responses API для многошагового ассистента, custom node только после проверки владельца, endpoint, ключей и условий обработки данных.
| Задача | Стартовый маршрут | Что проверить до усложнения |
|---|---|---|
| GPT Image 2 должен остаться в ComfyUI-графе | официальный OpenAI Partner Node | узел виден, model выбирается как gpt-image-2, аккаунт выполняет один запрос |
| Нужно создать или отредактировать изображение из кода | OpenAI Image API | файл сохраняется, ошибки логируются, параметры можно валидировать |
| Генерация является частью chat, agent или tool flow | Responses API | результат связан с контекстом, tool call и файлом вывода |
| Требуется provider или GitHub custom node | аудит, затем узкий тест | endpoint, key storage, limits, data path, maintainer и support понятны |
Не начинайте с большого графа, batch, upscale, масок, нескольких reference images и стороннего провайдера одновременно. Минимальный порядок надежнее: обновить ComfyUI или открыть Comfy Cloud, добавить OpenAI GPT Image node, выбрать gpt-image-2, подтвердить API key, организационный доступ и состояние аккаунта, затем выполнить один text-to-image или один простой edit test. Если узел отсутствует, аккаунт не готов или сторонний node требует ключ от маршрута, который нельзя проверить, остановитесь на этом слое.
Что означает официальный маршрут ComfyUI
Официальная документация ComfyUI описывает GPT-Image-2 как маршрут OpenAI Partner Node. Это важная формулировка. Partner Node не превращает GPT Image 2 в локальную модель. Он позволяет узлу в ComfyUI вызвать внешний image model route и вернуть результат в граф. Локальные узлы до и после этого шага могут готовить вход, маску, композицию или post-processing, но центральная генерация остается удаленным вызовом.
Практически есть три слоя ответственности. Первый слой принадлежит ComfyUI: версия, Cloud или Desktop, node library, template, workflow JSON, соединения, пути входных изображений и Save Image. Второй слой принадлежит OpenAI API: key, organization verification, billing или usage state, policy, supported options, network route. Третий слой появляется только у custom nodes: кто поддерживает код, куда уходит запрос, где хранится secret, какой model ID реально отправляется, какие data terms действуют и как возвращаются ошибки.
| Слой | Владелец | Первый вопрос |
|---|---|---|
| ComfyUI graph | ваша среда или Comfy Cloud | узел импортирован, template загружается, входы и выходы соединены |
| OpenAI model route | OpenAI API account | key, organization, billing, eligibility, network и параметры готовы |
| Custom provider node | maintainer или provider | endpoint, key handling, model mapping, data terms и support проверены |
Если OpenAI GPT Image node не появляется в библиотеке, не делайте вывод, что GPT Image 2 недоступен. Это чаще говорит о версии ComfyUI, timing между Desktop и Cloud, кэше node library или неподгруженном template. Если узел есть, но ошибка относится к authentication или permission, граф почти наверняка не является главной причиной. Если custom route работает, а официальный нет, это тоже не доказательство против OpenAI Partner Node: вы уже тестируете другой контракт.
Сначала запустите официальный Partner Node
Начинайте с пустого workflow. Обновите ComfyUI до текущей версии или используйте Comfy Cloud, затем найдите OpenAI GPT Image node в библиотеке. В текущей официальной инструкции модель выбирается как gpt-image-2 в model field у OpenAI GPT Image node. Если поле отсутствует или показывает старые варианты, сначала обновите среду, проверьте template и перезапустите ComfyUI, а не устанавливайте случайный plugin из результатов.
Рабочий порядок можно удержать в семи шагах: открыть актуальную среду, убедиться в Partner Nodes, добавить OpenAI GPT Image node, выбрать gpt-image-2, ввести короткий prompt, выполнить один запрос, сохранить workflow после успешного результата. Такой порядок кажется медленным, но он резко снижает стоимость диагностики. Большой граф может ломаться из-за mask, размера input image, несовместимого downstream node, missing output, старого JSON или batch-настроек.
| Шаг | Цель | Что не делать при ошибке |
|---|---|---|
| Обновить ComfyUI или открыть Cloud | получить актуальные official nodes | не судить по старому screenshot |
| Добавить OpenAI GPT Image node | подтвердить наличие официального маршрута | не ставить custom node как первый обход |
Выбрать gpt-image-2 | зафиксировать модель вызова | не смешивать старые GPT Image nodes и новый model ID |
| Запустить один text-to-image | изолировать remote route | не добавлять upscale и reference images |
| Сохранить и открыть workflow снова | проверить воспроизводимость | не считать preview доказательством production route |
Edit workflow лучше проверять вторым. Официальные материалы ComfyUI показывают image-edit route для GPT-Image-2 и описывают edit path до 2K. Этого достаточно, чтобы проверить input image, edit instruction и output path, но не достаточно, чтобы обещать каждую API-level опцию прямо из узла. Если задача стала точной 4K-размерностью, сохранением файла и чтением pixel dimensions, переходите к маршруту GPT Image 2 4K.
Проверьте аккаунт до отладки графа
GPT Image 2 внутри ComfyUI все равно зависит от OpenAI API access. Документация OpenAI разделяет Image API, image edits и Responses API image tool, а также указывает, что GPT Image models могут требовать organization verification. Это означает, что технически правильный ComfyUI graph может упасть из-за аккаунта, организации, billing state, network или policy.
Проверьте пять пунктов до того, как двигать узлы. API key должен быть доступен узлу и не попадать в workflow JSON. Organization access должен позволять вызывать GPT Image models. Billing или usage state не должен блокировать image operation. Network route должен позволять desktop или container достучаться до OpenAI. Наконец, параметры запроса должны соответствовать тому, что узел реально exposes, а не всему, что возможно в API.
| Проверка | Почему важна | Что обычно означает сбой |
|---|---|---|
| API key | официальный узел делает remote call | key отсутствует, просрочен, неправильно сохранен или недоступен процессу |
| Organization access | GPT Image models могут требовать verification | аккаунт аутентифицируется, но не имеет model eligibility |
| Billing / usage state | image generation является account-level operation | лимит, billing, policy или quota блокирует маршрут |
| Network | модель не запускается локально | firewall, proxy, container или desktop environment мешает запросу |
| Supported options | узел может не поддерживать все API параметры | size, background, format или edit behavior не относится к текущему node route |
Самый быстрый isolation test — выполнить прямой OpenAI image request вне ComfyUI тем же аккаунтом. Если прямой API не работает, продолжение отладки графа не поможет. Если прямой API работает, а ComfyUI падает, смотрите import, template, environment variable, model field и wiring. Вопросы бесплатного доступа не должны занимать этот маршрут: для официального entitlement используйте ответ о бесплатности GPT Image 2 API, а для provider/free/unlimited claims — аудит бесплатных маршрутов.
Выполните один text-to-image и один edit test
Первый prompt должен быть простым и проверяемым. Хороший test prompt описывает чистую техническую схему с тремя блоками: ComfyUI graph, OpenAI remote API, saved output. Избегайте tiny text, brand logos, нескольких reference images, сложных masks, batch и downstream post-processing. Вы проверяете маршрут, а не финальное качество изображения.
После успешного запуска проверьте три вещи: был ли выбран gpt-image-2, сохранился ли output в ожидаемый path, открывается ли workflow повторно с тем же узлом и настройками. Если эти три пункта не стабильны, добавление control nodes, upscale или production assets только скроет источник ошибки.
Edit test должен быть таким же узким. Возьмите одно входное изображение и попросите небольшое изменение: заменить фон, добавить простой объект или изменить материал. Это проверяет input path, edit node, account permission и output path одновременно. Если простой edit падает, сложный production edit не даст больше информации.
На этом этапе становится важна граница privacy и latency. ComfyUI может выполнять локальную подготовку, но GPT Image 2 call отправляет данные по remote API route. Для проектов с чувствительными изображениями, строгими logging rules или ограничениями на внешние модели это может быть стоп-фактором даже при технически рабочем узле.
Выберите между ComfyUI, Image API и Responses API
Официальный Partner Node хорош тогда, когда генерация должна остаться внутри ComfyUI canvas. Reference preparation, mask workflow, compositing, upscale, multi-step visual system и ручная работа оператора обычно выигрывают от node graph. В этом случае результат GPT Image 2 может сразу перейти в следующие ComfyUI nodes.
Direct Image API лучше для backend и scripts. Если web app создает одно изображение, internal tool редактирует product photo или service тестирует набор prompts, прямой API проще логировать, повторять, ограничивать по cost и проверять. ComfyUI тогда добавляет dependency без workflow value.
Responses API подходит, когда image generation является одним tool внутри broader assistant. Приложение может прочитать brief, выбрать prompt, создать изображение, объяснить изменения и сохранить state. Это не визуальный node graph; это application flow. Выбор зависит от того, где находится оператор и где хранится состояние.
| Маршрут | Лучше всего | Не подходит, если |
|---|---|---|
| Official ComfyUI OpenAI Partner Node | visual graph workflows с подготовкой и post-processing | нужен только один backend call |
| OpenAI Image API | app code, services, scripts, прямые edits | output обязан продолжить путь в ComfyUI graph |
| Responses API image tool | assistant, agent, multi-tool flow | нужен ручной node canvas |
| Third-party custom node | provider-specific constraint после аудита | невозможно проверить endpoint, keys, data path, limits или support |
Проверяйте custom nodes до установки
Custom node может быть полезным, но это другой контракт. Как только route проходит через provider, gateway или сторонний endpoint, меняются владелец счета, data path, storage, retries, support, limits и model mapping. Установка в ComfyUI не делает такой node официальным маршрутом.
Аудит начинайте с repository hygiene: maintainer, license, release history, issues, install instructions. Затем смотрите код: какие endpoint и base_url используются, как читается API key, не попадает ли key в logs, URL или workflow JSON, сохраняется ли upstream error. После этого проверяйте model label: UI может писать GPT Image 2, но фактический request должен быть понятен и проверяем.
| Вопрос аудита | Сигнал продолжать | Стоп-сигнал |
|---|---|---|
| Кто maintainer | видны release, issue, license и support | anonymous или stale repo |
| Какой endpoint | provider и route явно указаны | routing спрятан или идет через непонятный service |
| Как хранятся keys | secret остается в ожидаемом config | key попадает в workflow, logs, URL или examples |
| Какая модель вызывается | gpt-image-2 mapping документирован и тестируется | label есть, реального model mapping нет |
| Как выглядят failures | сохраняются auth, limit, network, parameter reasons | все сводится к generic broken node |
| Какие limits и data terms | есть docs по usage, retention, rights, support | обещания удобства без владельца и условий |
Используйте custom node только для конкретной причины: корпоративный provider route, уже одобренный gateway, внутренняя billing route или workflow, который официальный node не покрывает. Даже тогда first run должен быть с низкорисковым изображением, без реальных customer assets и без secret в shared workflow.
Классифицируйте ошибки по слоям
Большинство проблем не требуют полной перестройки графа. Missing node — это версия или import. Missing gpt-image-2 option — node/template state. Authentication error — account route. Text-to-image работает, edit падает — input или edit workflow. 4K или transparent background падают — option boundary. Custom node работает, official node нет — разные маршруты.
| Симптом | Вероятный слой | Первый шаг |
|---|---|---|
| OpenAI GPT Image node отсутствует | ComfyUI install или Partner Node availability | обновить ComfyUI, проверить Cloud/Desktop timing, перезагрузить node library |
Узел есть, но нет gpt-image-2 | node version или model list | обновить, перезапустить, сверить official template |
| Auth или permission error | OpenAI account route | проверить key, organization, billing, model eligibility и network |
| Text-to-image работает, edit нет | input/edit workflow | уменьшить input, упростить mask, убрать downstream nodes |
| Custom node работает, official нет | route mismatch | отделить provider success от OpenAI account readiness |
| 4K или transparent background падает | option support boundary | проверять API docs и 4K route, а не предполагать поддержку узла |
| Output медленный или нестабильный | remote route, account state или graph load | сравнить direct API, one-node workflow и production graph |
Логи должны показывать node, request, account, parameter и response state. Без этого замена одного node на другой только меняет форму неопределенности. Производственный workflow должен иметь точку остановки: если account route не доказан, сложный граф не тестируется; если custom endpoint не объяснен, реальные материалы туда не отправляются.
Когда нужны соседние маршруты
Точный 4K output, custom size, сохранение файла и чтение pixels относятся к GPT Image 2 4K workflow. ComfyUI может быть частью визуального процесса, но API-level размер лучше валидировать в специализированном маршруте.
Вопрос official free entitlement относится к GPT Image 2 API free-tier answer. Provider credits, browser wrappers, no-login routes и unlimited claims относятся к free/unlimited route audit. Эти темы лучше не смешивать с настройкой Partner Node, иначе first action потеряет ясность.
Если задача — заменить Nano Banana Pro внутри ComfyUI, используйте ComfyUI Nano Banana Pro alternative route. Replacement model selection, hosted/open-weight/API choices и migration constraints отличаются от официального подключения GPT Image 2.
Практический вывод: когда GPT Image 2 должен работать внутри ComfyUI graph, начинайте с OpenAI Partner Node, докажите account readiness, выполните один generation и один edit test, а затем решайте, нужен ли direct API или audited custom node.
Часто задаваемые вопросы
GPT Image 2 официально доступен в ComfyUI?
Да. Официальные материалы ComfyUI представляют GPT Image 2 через OpenAI Partner Node. Для графового workflow этот маршрут должен идти первым, пока нет конкретной причины использовать другой endpoint.
GPT Image 2 является локальной моделью ComfyUI?
Нет. В официальном маршруте ComfyUI управляет графом, а GPT Image 2 выполняется через удаленный OpenAI image route. Это не локальный checkpoint и не offline inference.
Какой узел выбрать?
Используйте официальный OpenAI GPT Image Partner Node и выбирайте gpt-image-2 в model field. Если узла или model option нет, обновите ComfyUI, template и node library до установки custom node.
Нужен ли OpenAI API key?
Для official Partner Node нужно готовить OpenAI API access: key, organization verification, billing/account state, network и model eligibility. Ошибка account route не решается перестановкой downstream nodes.
Можно ли получить 4K прямо из ComfyUI?
Не предполагайте, что ComfyUI node exposes все API-level output options. Для точных 4K размеров проверяйте size, сохраненный файл и реальные pixels в 4K workflow.
Безопасны ли custom nodes для GPT Image 2?
Они могут быть полезны, но требуют аудита. Проверьте maintainer, endpoint, key handling, model mapping, data terms, limits, maintenance и error behavior. Если эти пункты неясны, production assets не должны идти через такой маршрут.
Когда выбирать ComfyUI, а когда прямой OpenAI API?
ComfyUI выбирают, когда изображение должно пройти через node graph. Image API выбирают для прямого app или script call. Responses API выбирают, когда image generation является одним tool внутри assistant или agent flow.
