Что значит prompt invalid prompt в ComfyUI
Почему ComfyUI пишет Prompt is invalid: как найти проблемную ноду, проверить обязательные входы, модель и лог, затем запустить workflow.
Короткий ответ. Сообщение Prompt is invalid в ComfyUI означает, что граф не прошёл проверку перед выполнением. Это не «плохой текст промпта» в художественном смысле. Обычно проблема в пустом обязательном входе, неверно выбранной модели, несовместимом типе соединения или кастомной ноде, которая не загрузилась. Начните с первой подробной ошибки в интерфейсе и журнале сервера, затем исправляйте конкретный узел. В коде проверки графа ComfyUI видно, что причины возвращаются по отдельным нодам и выходам.
Что ComfyUI проверяет до генерации
Когда вы нажимаете запуск, ComfyUI превращает видимый workflow в набор задач. До загрузки модели он проверяет, существует ли тип каждой нужной ноды, присутствуют ли обязательные значения и можно ли пройти от входов к выходным нодам. Если проверка не прошла, видеокарта может вообще не начинать работу. Поэтому чистить VRAM или менять sampler при любой ошибке invalid prompt — неверный первый шаг. Сначала выясните, что именно не принято валидатором. Источник: ComfyUI execution.py.
Текстовые поля positive и negative prompt тоже могут участвовать в проблеме, но чаще сама фраза «prompt is invalid» относится ко всему графу. В интерфейсе найдите выделенный узел и подробность вроде отсутствующего значения, недоступного имени файла или неверного входного типа. В терминале ищите строку непосредственно перед итоговым сообщением, а не только последний красный текст.
Порядок поиска ошибки
- Сохраните копию текущего JSON, чтобы можно было вернуться к исходной схеме.
- Запустите граф один раз и запишите точный текст ошибки вместе с номером и названием узла.
- Откройте указанный узел. Проверьте пустые выпадающие списки checkpoint, VAE, text encoder, LoRA и входной картинки.
- Проверьте соединения: не удалили ли провод от обязательного входа, нет ли ноды после обновления с новым набором входов.
- Если узел кастомный, посмотрите лог загрузки пакета. Папка в
custom_nodesещё не доказывает, что импорт прошёл успешно. - Исправьте одну причину и запустите короткий тест; не обновляйте одновременно все пакеты и модель.
Если ошибка возникла после загрузки чужого workflow, сначала разделите два случая. Красные блоки указывают на недостающие типы нод. Обычные блоки с пустым выбором модели означают, что сам пакет нод есть, но нужного файла нет в вашей установке. Это разные действия: в первом случае нужна совместимая нода, во втором — правильная модель и её каталог. Инструкция по установке кастомных нод ComfyUI помогает проверить первый случай.
Типичные сообщения и следующие действия
| Симптом | Что проверить |
|---|---|
| Value not in list | Выбранного файла или значения больше нет в выпадающем списке; выберите доступный вариант. |
| Required input is missing | Подключите вход или заполните обязательное поле ноды. |
| Node type not found | Проверьте установку, загрузку и версию пакета кастомных нод. |
| Неподходящий тип данных на входе | Сравните выход предыдущей ноды с ожидаемым типом входа. |
Это ориентиры, а не универсальная расшифровка каждой версии ComfyUI. Кастомные ноды могут возвращать собственные тексты ошибок. В таком случае читайте документацию именно их репозитория. Если вам прислали workflow вместе с моделями, убедитесь, что имена файлов в графе совпадают с тем, что ComfyUI показывает после перезапуска.
Когда проблема в API JSON
API-формат и файл для визуального редактирования имеют разное назначение. Если внешний скрипт отправляет JSON на endpoint ComfyUI, проверить нужно не только синтаксис JSON, но и наличие class_type, существующих ID узлов и корректных ссылок между ними. Валидатор не установит кастомную ноду автоматически. Сначала откройте исходный workflow в интерфейсе и добейтесь одного успешного прогона вручную, затем экспортируйте вариант для API и проверьте запрос.
Для чистой диагностики полезно удалить из копии графа второстепенные ветки и оставить одну выходную ноду. Если минимальный граф работает, возвращайте части по одной. Так вы найдёте участок, на котором появляется ошибка, без бессмысленной переустановки всей сборки.
Частые вопросы
Поможет ли перезапуск?
После установки или обновления ноды — часто нужен полный перезапуск Python-процесса. При пустом поле модели или обрыве связи перезапуск ничего не исправит.
Нужно ли менять сам текст запроса?
Только если подробная ошибка указывает на текстовое поле конкретной ноды. В большинстве случаев сначала проверяйте структуру workflow и обязательные значения.