Узлы ComfyUI

Пакет узлов SpicyAPI для ComfyUI превращает каждую модель SpicyAPI для изображений, видео и звука в узел ComfyUI: таких узлов больше 180, и к ним добавлены узел SpicyAPI Chat для текстовых моделей и узел SpicyAPI LoRA. Модели работают на серверах SpicyAPI, поэтому вам нужны подключение к интернету и API-ключ, а не видеокарта и скачанные веса. Каждый узел показывает цену до запуска, а по завершении выводит, во сколько обошёлся запуск.

Пакет бесплатный и с открытым исходным кодом (MIT): github.com/spicyapi-ai/comfyui-spicyapi. Он ничего не устанавливает, кроме самого ComfyUI.

Подходит ли вам этот инструмент?

У всех способов общие аккаунт, баланс, модели и цены.

Перед началом

• Свежая версия ComfyUI. Узлы используют V3 node API ComfyUI и проверены на ComfyUI 0.39. Подойдёт любая установка, которая загружает папки из custom_nodes: десктопное приложение, портативная сборка или ручная установка.
• API-ключ. Создайте его в консоли; ключ начинается с sk-spicy-. Если аккаунта у вас ещё нет, см. Подготовка аккаунта.
• Баланс. Каждый запуск оплачивается из предоплаченного баланса в долларах США. См. Оплата.
• Доступ к api.spicyapi.ai с компьютера, на котором работает ComfyUI. Прокси, заданный через HTTPS_PROXY, учитывается.

Установка

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Добавьте API-ключ

Откройте Settings > SpicyAPI > API key и вставьте ключ. Уведомление подтвердит, что ключ работает, и покажет доступный баланс. Затем перезапустите ComfyUI ещё раз: список узлов строится по актуальному каталогу вашего аккаунта при запуске ComfyUI, а пока ключ не задан, используется список, поставляемый вместе с релизом.

Ключ хранится в файле в пользовательской папке ComfyUI (user/spicyapi/config.json), который доступен для чтения только вашей учётной записи. Он никогда не записывается ни в файл рабочего процесса, ни в метаданные изображения, которое сохраняет ComfyUI, поэтому, делясь любым из них, вы не делитесь ключом. После сохранения в поле настроек видны только последние четыре символа. Чтобы удалить ключ, очистите поле.

На сервере или в контейнере вместо этого задайте переменную окружения SPICY_API_KEY. Она имеет приоритет над полем в настройках.

Запустите первый узел

Хотите начать с готового графа? В браузере шаблонов ComfyUI примеры пакета находятся в разделе comfyui-spicyapi: текст в изображение, изображение в видео, чат-модель, пишущая промпт для модели изображений, синтез речи и LoRA.

Готовые примеры с реальными результатами, ценами и временем запуска, а также актуальный список узлов без цензуры есть на странице ComfyUI на spicyapi.ai.

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

Каждый узел создаётся по опубликованной входной схеме своей модели, той самой, по которой API проверяет запросы, поэтому узел никогда не предлагает параметр, который модель отклонила бы.

Выпадающий список со значением model default или число -1 в запрос не попадают, и модель использует собственное значение по умолчанию.

Выходы — обычные значения ComfyUI, поэтому их может принять любой другой узел:

• Модели изображений возвращают IMAGE. Удаление фона возвращает ещё и маску alpha.
• Модели видео возвращают VIDEO и, если включён return_last_frame, последний кадр клипа как IMAGE.
• Модели звука возвращают AUDIO. Модель, выдающая несколько клипов, например Suno, возвращает их одним пакетом, а Save Audio записывает каждый в отдельный файл.
• Распознавание речи возвращает STRING.
• Каждый узел также возвращает свой task_id — для логов в консоли или обращения в поддержку.

Узлы Chat и LoRA

SpicyAPI Chat отправляет промпт, необязательные системные инструкции и необязательные изображения любой текстовой модели SpicyAPI и возвращает ответ как STRING. Подключите его к prompt узла изображения или видео, чтобы языковая модель писала или улучшала промпты прямо в графе. Модель, которая не читает изображения, отклонит такой ввод, и ничего не будет списано.

SpicyAPI LoRA добавляет один файл весов LoRA, заданный прямой ссылкой на скачивание файла .safetensors, с силой от 0 до 4. Соедините несколько узлов в цепочку, чтобы наложить несколько LoRA, а последний подключите ко входу loras узла модели с LoRA (их названия оканчиваются на LoRA). Ссылка должна открываться без входа в аккаунт.

Сколько стоит запуск

• Значок на каждом узле показывает текущую ставку модели для выбранных вами параметров, например $0.0525/s для видео или $0.01/image, и меняется вместе с параметрами.
• Каждый запуск сначала оценивается. В Settings > SpicyAPI > Max cost per run задайте потолок в долларах США. Запуск, оценка которого выше потолка, останавливается до любого списания.
• Итоговая сумма появляется на узле, когда запуск завершается. Неудачные запуски не оплачиваются, кроме моделей, на странице которых сказано, что отказы оплачиваются. См. Оплата.
• Seed по умолчанию стоит в fixed. Повторная постановка того же графа в очередь использует первый результат, а не платит снова. Переключите control after generate в randomize, чтобы при каждом запуске получать новый результат и новое списание.
• Отмена прекращает ожидание, но не задачу. Запуск, который вы отменили в ComfyUI, продолжает выполняться в SpicyAPI, при успехе оплачивается, а его результат лежит в логах консоли.

Результаты хранятся в вашей консоли до 14 дней, а если ваш аккаунт задаёт более короткий срок хранения, то меньше. Чтобы сохранить собственную копию, используйте узлы Save в ComfyUI. См. Хранение и удаление данных.

Устранение неполадок

Ошибки SpicyAPI заканчиваются на request_id или ID задачи. Назовите его в поддержке, и запрос можно будет найти точно. Коды ошибок разобраны на странице Ошибки и повторы.