PopNowDocs API
Integrazioni
Contenuto principale

Nodo ComfyUI per la generazione in cloud

Esegui modelli cloud di immagini, video e audio con l’AI dentro ComfyUI con il pacchetto di nodi ufficiale PopNow da ComfyUI Manager, oppure con un unico file di nodo. Nessuna GPU né download di modelli; passaggi di installazione, input, prezzi e correzioni degli errori.

Il pacchetto di nodi ufficiale PopNow porta ogni modello di immagini, video e audio di PopNow in un grafo ComfyUI. Ogni nodo invia l’attività al cloud, attende e passa il risultato al nodo successivo. Non si scarica nulla sulla tua GPU, quindi i modelli video che richiedono molta più memoria di un portatile girano senza problemi da un portatile.

Il pacchetto è popnow-comfyui sul Comfy Registry, open source su GitHub. Aggiunge un nodo per modello, un nodo PopNow Generate che accetta qualsiasi modello per nome, e un nodo PopNow LoRA. Questa pagina corrisponde alla pagina ComfyUI su popnow.ai.

Installazione in quattro passi

Installa il pacchetto di nodi

In ComfyUI, apri Manager > Custom Nodes Manager, cerca PopNow, clicca Install e riavvia ComfyUI. Con la Comfy CLI:

comfy node install popnow-comfyui

Il pacchetto non richiede nulla oltre a ComfyUI stesso (Python 3.10 o successivo). Per installare dal sorgente, clona popnow-comfyui in ComfyUI/custom_nodes.

Aggiungi la tua chiave API

Crea una chiave nella console API, apri Settings > PopNow in ComfyUI e incollala. Le esecuzioni usano il saldo API separato in USD, inizialmente di $0. Aggiungi fondi in Fatturazione API; i crediti del sito non pagano queste esecuzioni. Oppure imposta la chiave nell’ambiente da cui avvii ComfyUI:

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

Sulle build portable per Windows, aggiungi set POPNOW_API_KEY=sk-popnow-... al file .bat che avvia ComfyUI. Riavvia ancora una volta così l’elenco dei nodi viene caricato dal tuo account.

Aggiungi un nodo

Fai doppio clic sulla tela e scrivi il nome di un modello (seedance, kling, wan, nano banana, suno …), oppure sfoglia PopNow > Video / Image / Audio. PopNow Generate accetta qualsiasi ID di modello da Modelli.

Metti in coda

Collega Load Image all’input immagine se il modello ne accetta una, collega Save Image, Save Video o Save Audio, e metti in coda il prompt. Il browser dei template di ComfyUI ha grafi pronti sotto popnow-comfyui.

Il nodo a file singolo

Se preferisci un unico file che puoi leggere in un minuto, il nodo PopNow Generate del pacchetto esiste anche come singolo file Python. Salvalo come custom_nodes/popnow_api.py dentro la cartella di ComfyUI, imposta POPNOW_API_KEY come sopra e riavvia ComfyUI. Usa solo requests, Pillow, NumPy e PyTorch, che ComfyUI include già.

Installa il pacchetto oppure questo file, non entrambi: aggiungono lo stesso nodo. Quando passi al pacchetto, elimina custom_nodes/popnow_api.py; i workflow salvati continuano a funzionare.

Input e output

Questi sono gli input e gli output di PopNow Generate, uguali nel pacchetto e nel file singolo. I nodi per modello del pacchetto mostrano invece i campi di ciascun modello, come menu a tendina, cursori e socket.

InputCosa inserire
modelUn ID di modello da Modelli, per esempio google/nano-banana-2.1/text-to-image o minimax/h3/image-to-video
promptCosa creare. Lascialo vuoto per i modelli che non accettano un prompt
optionsGli altri campi del modello in JSON, come {"resolution": "2k"} o {"duration_seconds": 5}. La pagina di ogni modello li elenca
image (facoltativo)Un IMAGE proveniente da un altro nodo. Viene caricato per te e inserito nel campo indicato da image_field
image_fieldQuale campo riceve l’immagine: image_url per la maggior parte dei modelli video, image_urls per la modifica di immagini
OutputContiene
imageIl risultato come IMAGE per i modelli di immagini; un segnaposto vuoto per video e audio
urlL’URL firmato del file, valido per circa 20 minuti
pathPer video e audio: dove è stato salvato il file nella cartella di output di ComfyUI

Configurazioni comuni

Obiettivomodeloptionsimage_field
Da testo a immaginegoogle/nano-banana-2.1/text-to-image{"aspect_ratio": "16:9", "resolution": "1k"}—
Modificare un render localegoogle/nano-banana-2.1/edit{"resolution": "2k"}image_urls
Animare un’immagine fissaminimax/h3/image-to-video{"duration_seconds": 5, "resolution": "768p"}image_url
Ingrandire un fotogrammapopnow/image-upscaler-v1/upscale{}image_url
Ritagliare il soggettopopnow/background-remover-v1/edit{}image_url

Un grafo ibrido tipico: crea un fotogramma iniziale con un checkpoint locale, animalo nel cloud con un modello da immagine a video, poi ricarica l’MP4 salvato con un nodo di caricamento video e ingrandiscilo o interpolalo in locale.

Cosa fa il nodo sotto il cofano

Il nodo è un involucro sottile sopra tre chiamate REST; le stesse chiamate in altri linguaggi:

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

Caricare l’immagine di input è il flusso in tre passi descritto in Media; il risultato è un riferimento popnow://f/… che funziona solo con le chiavi del tuo account.

Prezzi

Ogni esecuzione usa gli USD API al prezzo normale del modello; il nodo non aggiunge nulla. Nano Banana 2.1 a 1K costa $0.048 per immagine; MiniMax H3 a 768p costa $0.185 per 5 secondi. Le esecuzioni fallite non vengono addebitate. I prezzi di ogni modello sono nella sua pagina e in Saldo API e rimborsi; usa jobs/quote per una cifra esatta.

Errori comuni

ComfyUI mostraPerchéSoluzione
No PopNow API key is set (pacchetto)Nessuna chiave in Settings > PopNow né nell’ambienteIncolla la chiave in Settings > PopNow, oppure imposta POPNOW_API_KEY, poi esegui di nuovo
Set POPNOW_API_KEY before starting ComfyUI (file singolo)La variabile non è nell’ambiente di ComfyUIImpostala nella stessa shell o nel file .bat, poi riavvia
PopNow 401: …Chiave mancante, scritta male o revocataCrea una nuova chiave nella console API
PopNow 400: … che indica un campooptions ha un campo che il modello non accetta, oppure un valore fuori intervalloControlla la pagina del modello; i campi sconosciuti vengono rifiutati
PopNow 40201: …USD API insufficientiAggiungi fondi in Fatturazione API, oppure riduci risoluzione o durata
PopNow failed: …Il modello non ha potuto terminare o ha rifiutato la richiestaNon è stato addebitato nulla; cambia prompt o impostazioni
JSONDecodeErroroptions non è JSON validoUsa le virgolette doppie: {"resolution": "2k"}
Il nodo non compare nella ricercaIl pacchetto o il file non è installato, oppure ComfyUI non è stato riavviatoControlla Custom Nodes Manager o la cartella custom_nodes, riavvia e cerca gli errori di import nella console
Un modello di popnow.ai non ha un nodoIl pacchetto costruisce l’elenco dei nodi dal catalogo del tuo account all’avvio di ComfyUIRiavvia ComfyUI, oppure usa PopNow Generate con l’ID del modello

È un pacchetto ufficiale nel registry di ComfyUI?

Sì. popnow-comfyui è pubblicato da PopNow sul Comfy Registry, quindi ComfyUI Manager e comfy node install popnow-comfyui lo trovano entrambi. Il sorgente è su GitHub con licenza MIT. Il nodo a file singolo di questa pagina è il suo nodo PopNow Generate in un solo file. Vedi SDK, CLI e strumenti open source.

Funziona con ComfyUI Desktop e le build portable?

Sì. Funziona ovunque si possano installare nodi personalizzati: portable, Desktop e server self-hosted.

Mi serve una GPU?

No. La generazione avviene dal lato di PopNow; la tua macchina invia solo la richiesta e riceve il file.

Come riporto i fotogrammi video nel grafo?

Il nodo salva il video nella cartella di output di ComfyUI e restituisce il suo percorso. Caricalo con un nodo di caricamento video per ottenere i fotogrammi.

In questa pagina