Nó do ComfyUI para geração na nuvem

O pacote oficial de nós do PopNow coloca todos os modelos de imagem, vídeo e áudio do PopNow dentro de um grafo do ComfyUI. Cada nó envia o trabalho para a nuvem, espera o resultado e entrega o arquivo ao nó seguinte. Nada é baixado para a sua GPU, então modelos de vídeo que precisam de muito mais memória do que um notebook tem funcionam normalmente a partir do notebook.

O pacote é o popnow-comfyui no Comfy Registry, código aberto no GitHub. Ele adiciona um nó por modelo, um nó PopNow Generate que aceita qualquer modelo pelo nome, e um nó PopNow LoRA. Esta página acompanha a página do ComfyUI no popnow.ai.

Instale em quatro passos

comfy node install popnow-comfyui

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

O nó em um único arquivo

Se preferir um único arquivo que dê para ler em um minuto, o nó PopNow Generate do pacote também existe como um arquivo Python só. Salve-o como custom_nodes/popnow_api.py dentro da pasta do ComfyUI, defina POPNOW_API_KEY como acima e reinicie o ComfyUI. Ele usa apenas requests, Pillow, NumPy e PyTorch, que o ComfyUI já traz.

Instale o pacote ou este arquivo, não os dois: eles adicionam o mesmo nó. Ao migrar para o pacote, apague custom_nodes/popnow_api.py; os fluxos salvos continuam funcionando.

Entradas e saídas

Estas são as entradas e saídas do PopNow Generate, iguais no pacote e no arquivo único. Os nós por modelo do pacote mostram os campos próprios de cada modelo, como menus, controles deslizantes e conectores.

Configurações comuns

Um grafo híbrido típico: gere um quadro inicial com um checkpoint local, anime-o na nuvem com um modelo de imagem para vídeo, depois carregue o MP4 salvo com um nó de carregamento de vídeo e amplie ou interpole-o localmente.

O que o nó faz por dentro

O nó é uma camada fina sobre três chamadas REST; as mesmas chamadas em outras linguagens:

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"

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);

Enviar a imagem de entrada é o fluxo de três passos de Mídia; o resultado é uma referência popnow://f/… que só funciona com chaves da sua própria conta.

Preços

Cada execução gasta USD da API pelo preço normal do modelo; o nó não acrescenta nada. Nano Banana 2.1 em 1K custa $0.048 por imagem, e MiniMax H3 em 768p custa $0.185 por 5 segundos. Execuções que falham não são cobradas. Os preços de cada modelo estão na página dele e em Saldo da API e reembolsos; use jobs/quote para um valor exato.

Erros comuns

Este é um pacote oficial no registro do ComfyUI?

Sim. O popnow-comfyui é publicado pelo PopNow no Comfy Registry, então o ComfyUI Manager e o comfy node install popnow-comfyui o encontram. O código-fonte está no GitHub, sob licença MIT. O nó de arquivo único desta página é o nó PopNow Generate dele, em um arquivo só. Veja SDKs, CLI e ferramentas de código aberto.

Funciona com o ComfyUI Desktop e as versões portáteis?

Sim. Funciona em qualquer lugar onde você possa instalar nós personalizados: versão portátil, Desktop e servidores self-hosted.

Preciso de uma GPU?

Não. A geração roda do lado do PopNow; a sua máquina só envia a requisição e recebe o arquivo.

Como trago os quadros do vídeo de volta para o grafo?

O nó salva o vídeo na pasta de saída do ComfyUI e devolve o caminho. Carregue-o com um nó de carregamento de vídeo para obter os quadros.

Relacionados