Руководство по настройке

Руководство по настройке провайдера

Инструкции по настройке и устранению неполадок по инструментам.

Настройка ComfyUI

ComfyUI — это инструмент для работы с воркфлоу генерации изображений и видео. Это не обычный чат: его суть не в том, чтобы «выбрать модель и общаться», а в том, чтобы загрузить воркфлоу (граф процессов) и передать промпты, изображения и параметры в узлы (ноды).

Сначала разберитесь с воркфлоу

Воркфлоу ComfyUI обычно включает такие узлы (ноды), как загрузка модели, промпты, сэмплеры, размеры и сохранение результата. Линии и узлы на веб-странице показывают последовательность шагов для генерации изображений или видео.

Если вы хотите вызывать ComfyUI через API, обычно требуется экспортировать воркфлоу в формате JSON для API и отправить его на локальный или облачный сервис ComfyUI.

Интерфейс воркфлоу для справки Сначала разберитесь с узлами, связями и кнопкой запуска (Queue Prompt / Run), и лишь затем переходите к вызовам API. Главное в ComfyUI — не API-ключ, а работоспособность самого воркфлоу.
Интерфейс воркфлоу в официальной документации ComfyUI

Как указать локальный адрес

Параметр конфигурацииСпособ заполнения
Веб-адресhttp://127.0.0.1:8188
Адрес APIhttp://127.0.0.1:8188/prompt
Воркфлоуworkflow-api.json
ВыводПапка History / Output
  1. Сначала запустите ComfyUI и убедитесь, что страница http://127.0.0.1:8188 открывается в браузере.
  2. Загрузите в ComfyUI воркфлоу, который уже успешно генерирует изображения.
  3. Включите режим разработчика или опцию экспорта API и сохраните воркфлоу в виде API JSON.
  4. Отправьте этот JSON с помощью скрипта или API-запроса на /prompt.
  5. После завершения генерации проверьте полученные изображения в истории или в папке вывода (output).

Пример вызова API

Отправка воркфлоу в локальный ComfyUI
curl -X POST http://127.0.0.1:8188/prompt \ -H "Content-Type: application/json" \ -d @workflow-api.json
Большинство ошибок в воркфлоу для изображений и видео связаны с отсутствием файлов моделей, несовместимостью версий нод или нехваткой видеопамяти (VRAM), поэтому не ограничивайтесь проверкой только ключа и Base URL.

Часто задаваемые вопросы для новичков

ПроблемаЧто проверить в первую очередьРешение
Веб-интерфейс открывается, но API возвращает ошибкуУказан ли адрес запроса /prompt, экспортирован ли воркфлоу в формате APIСначала запустите генерацию через веб-интерфейс, затем заново экспортируйте API JSON
Сообщение: Missing node (Отсутствует узел)В воркфлоу используются кастомные ноды, которые не установлены на вашей машинеУстановите необходимые ноды по инструкции к воркфлоу или протестируйте базовый стандартный воркфлоу
Сообщение: Model file does not exist (Файл модели не найден)Пути к файлам checkpoint, LoRA, VAE и т. д.Поместите файл модели в соответствующую директорию ComfyUI, затем перезапустите и выберите его в списке
Недостаточно видеопамяти (CUDA out of memory)Разрешение изображения, размер пакета (batch size), размер моделиСначала уменьшите разрешение и batch size, убедитесь, что генерация проходит, а затем постепенно увеличивайте параметры