JSON Workflow

JSON Workflow — формат сохранения и обмена пайплайнами в ComfyUI. Каждый workflow — это JSON-файл с описанием нод, их параметров и связей между ними. Можно сохранить, отправить коллеге, опубликовать на Civitai — получатель загрузит файл в свой ComfyUI и получит идентичную сборку. Также внутри PNG-картинок ComfyUI хранит метаданные workflow для полной воспроизводимости.

Коротко

Коротко. JSON Workflow — это структурированный текстовый файл, в котором ComfyUI сохраняет всю информацию о workflow: какие ноды, какие параметры, как соединены. Загружается перетаскиванием в браузер. У ComfyUI два формата: «UI workflow» (для визуального редактора) и «API workflow» (для программного запуска). Также workflow встраивается в PNG-метаданные сгенерированных картинок — открытие такой PNG восстанавливает workflow целиком.

Что это такое

Иллюстратор настроил идеальный workflow в ComfyUI: SDXL + LoRA + Hires.fix + Face Restoration + сохранение с метками. Полтора часа мышью. Хочет поделиться с коллегой.

Без JSON-формата: записал бы видео, объяснил каждую ноду, коллега полдня собирал бы по аналогии. Скриншот не помогает — точные параметры не видны.

С JSON: меню File → Save (API Format) → файл cinematic_portrait.json 12 КБ. Отправляет коллеге в Telegram. Тот сохраняет на диск, перетаскивает в свой ComfyUI. Через секунду — точно тот же workflow, со всеми параметрами и связями.

Это и есть JSON Workflow — переносимый «рецепт» для ComfyUI.

К 2026-му это стандарт обмена в SD-сообществе:

• На Civitai к каждой опубликованной модели часто прикреплены workflow-файлы.
• В Discord-каналах ComfyUI делятся .json-ами как модами в играх.
• На GitHub есть репозитории-сборники workflow для конкретных задач.
• В YouTube-туториалах автор обычно прикладывает свой workflow в описании.

Как это работает

JSON-файл workflow содержит:

{
  "nodes": [
    {
      "id": 1,
      "type": "CheckpointLoaderSimple",
      "pos": [100, 200],
      "widgets_values": ["sd_xl_base_1.0.safetensors"]
    },
    {
      "id": 2,
      "type": "CLIPTextEncode",
      "pos": [400, 100],
      "widgets_values": ["A cinematic portrait..."]
    }
  ],
  "links": [
    [1, 1, 1, 2, 0, "MODEL"],
    [2, 1, 1, 2, 1, "CLIP"]
  ]
}

Ключевые элементы:

• nodes: список всех нод. У каждой — id, тип (имя класса), позиция на canvas, значения параметров.
• links: список соединений. Каждый link — [id_from, slot_from, id_to, slot_to, ...].
• groups, version, extra: метаданные для UI.

Когда ComfyUI загружает JSON, он:

1. Создаёт ноды по списку.
2. Подставляет параметры из widgets_values.
3. Восстанавливает соединения из links.
4. Получается готовый workflow.

Существует два формата JSON:

• UI Workflow — для редактора в браузере. Содержит позиции нод, цвета, заметки. Нужен, если хотите редактировать.
• API Workflow — для программного запуска через /prompt endpoint. Только функциональная часть, без UI-метаданных. Меньше размер, нужен для серверной автоматизации.

Пример на практике

Видеомонтажёр автоматизирует генерацию thumbnail-ов через ComfyUI API:

1. Создаёт workflow в браузере: SDXL + Text Overlay + Save с шаблонами имён.
2. Сохраняет API JSON: File → Save (API Format) → thumbnail_pipeline.json.
3. Пишет Python-скрипт:

import json, requests

with open('thumbnail_pipeline.json') as f:
    workflow = json.load(f)

# подменяем промпт
workflow["3"]["inputs"]["text"] = "Top 10 AI tools 2026"

# отправляем в ComfyUI API
resp = requests.post("http://localhost:8188/prompt",
                     json={"prompt": workflow})
print(resp.json())  # {"prompt_id": "..."}

4. Запускает скрипт для каждой темы видео. Через 5 секунд готовый thumbnail сохраняется в нужную папку.

Это классический паттерн «one-time setup, infinite reuse»: один раз в браузере собрал, дальше дергаешь через API столько, сколько нужно.

В ComfyUI Manager есть функция «Share Workflow» — экспортирует workflow + список используемых custom nodes для удобной передачи коллегам.

С чем часто путают

• JSON Workflow и Workflow в Photoshop — Photoshop тоже умеет «actions» в JSON. Это другие форматы для других программ.
• UI Workflow и API Workflow — два разных JSON. UI для визуального редактора, API для программного запуска. Из UI можно сделать API через export, обратно — нет.
• Workflow и Checkpoint — Workflow это инструкция «что делать». Checkpoint — это модель «чем делать». Разные сущности.
• JSON Workflow и Workflow.svg — SVG не используется ComfyUI для workflow. Только JSON или PNG-метаданные.
• PNG с метаданными и обычный PNG — оба .png. Только в первом внутри tEXt-чанка зашит JSON workflow. Можно посмотреть через exiftool или специальные сайты-ридеры.

Частые ошибки и заблуждения

• «JSON workflow содержит модели». Не содержит. Только названия моделей. Для запуска моделей нужно иметь их у себя в models/.
• «JSON работает с любым ComfyUI». Если в workflow используются custom nodes, которых у получателя нет — ноды будут красные, workflow не запустится. Manager → Install Missing помогает.
• «PNG с метаданными — это всегда воспроизводимая генерация». Не всегда. Если поменялись custom nodes или модели — результат может отличаться. Полная воспроизводимость требует фиксации всех версий.
• «API JSON можно открыть в браузере и редактировать». Нет. API формат — для запуска, не для редактирования. Открыть можно только UI формат.
• «Civitai-картинки всегда содержат workflow». Не всегда. Многие сайты пересжимают изображения и теряют PNG-метаданные. Проверяйте metadata поле на странице.

Связанные термины

• ComfyUI — программа, использующая JSON workflow.
• Custom Nodes — частая причина «красных нод» при импорте.
• ComfyUI Manager — помогает устанавливать недостающие ноды.
• Workflow — общий концепт, реализованный через JSON.
• PNG metadata — другой носитель того же workflow.
• API endpoint — /___NSLPROTECT3___, принимающий API-JSON.
• Civitai — главный источник готовых workflow.

Частые вопросы

Где найти готовые workflow? Civitai (раздел Workflows), OpenArt, GitHub-репозитории awesome-comfyui, Discord-каналы ComfyUI, YouTube-описания туториалов.

Можно ли редактировать JSON руками? Можно, но осторожно. Малейшая ошибка в синтаксисе JSON ломает всё. Проще менять параметры в браузере, потом пересохранять.

Что делать, если workflow не запускается? Посмотреть логи ComfyUI. Чаще всего проблема: missing custom nodes (Manager → Install Missing) или missing models (скачать вручную или через Model Manager).

Workflow можно встроить в JPEG? Нет. Только PNG поддерживает tEXt-чанк для произвольных метаданных. JPEG теряет workflow при сохранении.

Какой размер у типичного workflow JSON? 5–50 КБ для среднего workflow. Сложные пайплайны с 50+ нодами — до 200 КБ.

Можно ли версионировать workflow в git? Можно и нужно. JSON хорошо diff'ится, изменения видны построчно. Workflow-файлы часто хранят рядом с исходным кодом проекта.

Главное

JSON Workflow — это переносимый «рецепт» ComfyUI: всё описание нод, параметров и связей в одном текстовом файле. Загружается перетаскиванием в браузер; восстанавливает workflow целиком. Два формата: UI (для редактирования) и API (для автоматизации). Главный приём ComfyUI — workflow зашивается в PNG-метаданные, и открытие картинки восстанавливает пайплайн. Это превратило обмен ComfyUI-конфигами в норму: Civitai, GitHub, Discord — везде workflow в JSON. Главный нюанс — у получателя должны быть те же custom nodes и модели; ComfyUI Manager помогает с первыми, со вторыми — Model Manager.