Как экспортировать API JSON, чтобы не потерять ноды в ComfyUI
Как сохранить workflow ComfyUI в API JSON: используйте экспорт для API, проверьте имена нод и отправьте тестовый запрос на сервер.
Короткий ответ. Для редактирования и передачи графа сохраняйте обычный workflow JSON; для отправки на API ComfyUI экспортируйте отдельный API JSON из интерфейса. Эти форматы решают разные задачи. API JSON содержит исполняемые ноды, их class_type, входы и связи, но может не сохранять расположение блоков и другие удобные для редактора поля. Поэтому не заменяйте исходный визуальный файл единственной API-копией. Официальный OpenAPI ComfyUI описывает отправку workflow на сервер; форматы зависят от версии фронтенда.
Чем отличаются два файла
Обычный workflow JSON нужен человеку: его можно открыть на canvas и продолжить менять провода, группы и расположение узлов. API JSON нужен программе, которая вызывает сервер и передаёт набор нод в запросе. Он может выглядеть короче и потерять сведения о визуальном представлении, но это не значит, что ноды испарились. Проверьте, есть ли в файле их ID, class_type и нужные входы. Если планируете и редактировать, и автоматизировать, храните оба файла с разными понятными именами.
Команды меню менялись между версиями ComfyUI. Ищите действие экспорта в интерфейсе вашей версии и проверяйте результат, а не следуйте старому скриншоту дословно. Сначала добейтесь одного успешного запуска графа вручную; экспорт ошибок не исправляет.
Безопасный порядок экспорта
- Сохраните исходный workflow JSON под новым именем и убедитесь, что он открывается в редакторе.
- Проверьте, что все нужные выходные ноды подключены и не выключены.
- Экспортируйте API-формат через меню ComfyUI и назовите файл, например,
project_api.json. - Откройте API JSON в текстовом редакторе и проверьте, что в нём есть ожидаемые ID и типы нод.
- Отправьте тестовый запрос на свой ComfyUI API и сравните результат с ручным запуском.
- Храните оба файла вместе с версией ComfyUI и списком кастомных пакетов.
Если API JSON кажется «пустым», посмотрите, какая часть графа реально приводит к выходной ноде. Неиспользуемая ветка или UI-элемент, который не участвует в выполнении, может не попасть в исполняемый формат. Выключенные или bypass-ноды тоже требуют проверки: экспортируйте после того, как нужный путь включён, и сравните список типов нод. Если файл загружается в API, но не даёт output, проверяйте связи до Save Image или видеовыхода.
Что экспорт не включает автоматически
JSON обычно ссылается на имена моделей и классы нод, но не упаковывает сами гигабайтные веса или Python-код расширений. На другой машине тот же API JSON может не исполниться без установленного пакета, совместимой версии и файла модели в нужном каталоге. Также он не переносит ваши локальные входные изображения автоматически: для API-запуска их нужно передать способом, который ожидает сервер. В официальной спецификации API отдельно описаны запросы к серверу.
Если вы передаёте граф другому человеку, приложите обычный workflow JSON, список кастомных нод и список моделей с версиями. Не включайте в публичный файл токены, приватные пути или личные фотографии. Проверьте JSON текстовым поиском перед публикацией. Это особенно важно для экспортов из графов с API-партнёрами и внешними сервисами.
Диагностика ошибки после экспорта
| Симптом | Вероятная проверка |
|---|---|
| Файл не открывается на canvas | Не перепутан ли API JSON с обычным workflow |
| API пишет invalid prompt | Обязательные входы, типы нод и имена моделей |
| На другом компьютере missing nodes | Установлены ли пакеты кастомных нод |
| Нет итогового файла | Есть ли исполняемая выходная нода и её путь |
Не редактируйте вручную большой JSON без копии. Одна неверная ссылка на ID ноды может сломать цепочку. Если меняете параметры через API, изменяйте только заранее выбранные входы и проверяйте коротким запросом. При переносе на новый сервер начинайте с одного входного файла, а не сразу с пакетной очереди.
Частые вопросы
Почему в API JSON нет координат блоков?
Это исполняемое представление, а не полная схема интерфейса. Сохраните обычный workflow отдельно для визуального редактирования.
Сохранит ли экспорт кастомные ноды?
Он сохранит ссылки на их типы, но не установит код пакетов на другом сервере. Нужны совместимые расширения и модели.