PopNowДокументация API
Интеграции
Основное содержимое

Узел ComfyUI для облачной генерации

Запускайте облачные AI-модели изображений, видео и аудио внутри ComfyUI с официальным пакетом узлов PopNow из ComfyUI Manager или одним файлом пользовательского узла. Без GPU и загрузки моделей; шаги установки, входы, цены и решения ошибок.

Официальный пакет узлов PopNow переносит все модели PopNow для изображений, видео и аудио в граф ComfyUI. Каждый узел отправляет задачу в облако, ждёт и передаёт результат следующему узлу. На вашу видеокарту ничего не скачивается, поэтому видеомодели, которым нужно гораздо больше памяти, чем есть в ноутбуке, работают и на ноутбуке.

Пакет — это popnow-comfyui в Comfy Registry, открытый исходный код на GitHub. Он добавляет по одному узлу на каждую модель, узел PopNow Generate, который принимает любую модель по названию, и узел PopNow LoRA. Эта страница соответствует странице ComfyUI на popnow.ai.

Установка в четыре шага

Установите пакет узлов

В ComfyUI откройте Manager > Custom Nodes Manager, найдите PopNow, нажмите Install и перезапустите ComfyUI. Через Comfy CLI:

comfy node install popnow-comfyui

Пакету не нужно ничего, кроме самого ComfyUI (Python 3.10 или новее). Чтобы установить из исходников, клонируйте popnow-comfyui в ComfyUI/custom_nodes.

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

Создайте ключ в API-консоли, откройте в ComfyUI Settings > PopNow и вставьте его. Запуски расходуют отдельный баланс API в USD с начальным значением $0. Пополните его в разделе Оплата API; кредиты сайта не оплачивают эти запуски. Или задайте ключ в окружении, из которого запускаете ComfyUI:

export POPNOW_API_KEY="sk-popnow-..."
python main.py

В портативных сборках Windows добавьте set POPNOW_API_KEY=sk-popnow-... в .bat-файл, которым запускается ComfyUI. Перезапустите ещё раз, чтобы список узлов подгрузился из вашего аккаунта.

Добавьте узел

Дважды кликните по холсту и введите название модели (seedance, kling, wan, nano banana, suno …) или откройте PopNow > Video / Image / Audio. PopNow Generate принимает любой ID модели из раздела Модели.

Поставьте в очередь

Если модель принимает изображение, подключите Load Image ко входу изображения, подключите Save Image, Save Video или Save Audio и поставьте промпт в очередь. В браузере шаблонов ComfyUI есть готовые графы в разделе popnow-comfyui.

Узел из одного файла

Если вы предпочитаете один файл, который можно прочитать за минуту, узел PopNow Generate из пакета есть и в виде одного Python-файла. Сохраните его как custom_nodes/popnow_api.py в папке ComfyUI, задайте POPNOW_API_KEY, как описано выше, и перезапустите ComfyUI. Он использует только requests, Pillow, NumPy и PyTorch — всё это уже есть в ComfyUI.

Установите либо пакет, либо этот файл, но не оба: они добавляют один и тот же узел. Перейдя на пакет, удалите custom_nodes/popnow_api.py; сохранённые воркфлоу продолжат работать.

Входы и выходы

Это входы и выходы PopNow Generate; в пакете и в одном файле они одинаковые. Узлы по моделям в пакете показывают поля каждой модели отдельно — в виде выпадающих списков, ползунков и разъёмов.

ВходЧто в него вписать
modelID модели из раздела Модели, например google/nano-banana-2.1/text-to-image или minimax/h3/image-to-video
promptЧто создать. Оставьте пустым для моделей, которые не принимают промпт
optionsОстальные поля модели в виде JSON, например {"resolution": "2k"} или {"duration_seconds": 5}. Их перечень есть на странице каждой модели
image (необязательно)IMAGE из другого узла. Он загружается за вас и помещается в поле, указанное в image_field
image_fieldКакое поле получит изображение: image_url для большинства видеомоделей, image_urls для редактирования изображений
ВыходЧто содержит
imageРезультат как IMAGE для моделей изображений; пустая заглушка для видео и аудио
urlПодписанная ссылка на файл, действует около 20 минут
pathДля видео и аудио: куда сохранён файл в папке вывода ComfyUI

Типичные настройки

Цельmodeloptionsimage_field
Текст в изображениеgoogle/nano-banana-2.1/text-to-image{"aspect_ratio": "16:9", "resolution": "1k"}—
Редактировать локальный рендерgoogle/nano-banana-2.1/edit{"resolution": "2k"}image_urls
Оживить кадрminimax/h3/image-to-video{"duration_seconds": 5, "resolution": "768p"}image_url
Увеличить кадрpopnow/image-upscaler-v1/upscale{}image_url
Вырезать объектpopnow/background-remover-v1/edit{}image_url

Типичная смешанная схема: создайте начальный кадр локальным чекпойнтом, оживите его в облаке моделью «изображение в видео», затем загрузите сохранённый MP4 обратно узлом загрузки видео и увеличьте или интерполируйте его локально.

Что делает узел внутри

Узел — тонкая обёртка над тремя REST-вызовами; те же вызовы на других языках:

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "google/nano-banana-2.1/text-to-image", "input": {"prompt": "A lighthouse on a cliff at dusk, warm window light", "aspect_ratio": "16:9", "resolution": "1k"}}'

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=job_..." \
  -H "Authorization: Bearer $POPNOW_API_KEY"
JavaScript
const API = 'https://api.popnow.ai/api/v1';
const auth = { Authorization: `Bearer ${process.env.POPNOW_API_KEY}` };
const created = await fetch(`${API}/jobs/createTask`, {
  method: 'POST',
  headers: { ...auth, 'Content-Type': 'application/json', 'Idempotency-Key': crypto.randomUUID() },
  body: JSON.stringify({
    model: 'google/nano-banana-2.1/text-to-image',
    input: { prompt: 'A lighthouse on a cliff at dusk, warm window light', aspect_ratio: '16:9', resolution: '1k' },
  }),
}).then((r) => r.json());
console.log(created.data.taskId);

Загрузка входного изображения — это трёхшаговый процесс из раздела Медиа; результат — ссылка popnow://f/…, которая работает только с ключами вашего аккаунта.

Цены

Каждый запуск расходует USD API по обычной цене модели; узел ничего не добавляет. Nano Banana 2.1 в 1K — $0.048 за изображение, MiniMax H3 в 768p — $0.185 за 5 секунд. Неудачные запуски не списываются. Цены всех моделей указаны на их страницах и в разделе Баланс API и возвраты; для точной суммы используйте jobs/quote.

Частые ошибки

ComfyUI показываетПричинаРешение
No PopNow API key is set (пакет)Ключа нет в Settings > PopNow и в окруженииВставьте ключ в Settings > PopNow или задайте POPNOW_API_KEY, затем запустите снова
Set POPNOW_API_KEY before starting ComfyUI (один файл)Переменной нет в окружении ComfyUIЗадайте её в той же оболочке или .bat-файле и перезапустите
PopNow 401: …Ключ отсутствует, набран с ошибкой или отозванСоздайте новый ключ в API-консоли
PopNow 400: … с названием поляВ options есть поле, которое модель не принимает, или значение вне диапазонаПроверьте страницу модели; неизвестные поля отклоняются
PopNow 40201: …Недостаточно USD APIПополните баланс в разделе Оплата API или уменьшите разрешение или длительность
PopNow failed: …Модель не смогла завершить работу или отклонила запросНичего не списано; измените промпт или настройки
JSONDecodeErroroptions не является корректным JSONИспользуйте двойные кавычки: {"resolution": "2k"}
Узла нет в списке поискаПакет или файл не установлены, либо ComfyUI не перезапускалиПроверьте Custom Nodes Manager или папку custom_nodes, перезапустите ComfyUI и посмотрите в консоли ошибки импорта
У модели с popnow.ai нет узлаПакет строит список узлов по каталогу вашего аккаунта при запуске ComfyUIПерезапустите ComfyUI или используйте PopNow Generate с ID модели

Это официальный пакет в реестре ComfyUI?

Да. popnow-comfyui опубликован PopNow в Comfy Registry, поэтому ComfyUI Manager и comfy node install popnow-comfyui находят его оба. Исходный код открыт на GitHub под лицензией MIT. Узел из одного файла на этой странице — это узел PopNow Generate в одном файле. См. SDK, CLI и инструменты с открытым кодом.

Работает ли это с ComfyUI Desktop и портативными сборками?

Да. Работает везде, где можно установить пользовательские узлы: в портативной сборке, в Desktop и на собственных серверах.

Нужна ли видеокарта (GPU)?

Нет. Генерация идёт на стороне PopNow; ваш компьютер только отправляет запрос и получает файл.

Как вернуть кадры видео обратно в граф?

Узел сохраняет видео в папку вывода ComfyUI и возвращает путь к нему. Загрузите его узлом загрузки видео, чтобы получить кадры.

На этой странице