PopNowAPI-Doku
Integrationen
Hauptinhalt

ComfyUI-Node für Cloud-Generierung

Führe KI-Modelle für Bild, Video und Audio in der Cloud direkt in ComfyUI aus – mit dem offiziellen PopNow-Node-Paket aus dem ComfyUI Manager oder mit einer einzelnen Node-Datei. Keine GPU, keine Modell-Downloads; Installationsschritte, Eingaben, Preise und Fehlerlösungen.

Das offizielle PopNow-Node-Paket bringt jedes Bild-, Video- und Audiomodell von PopNow in einen ComfyUI-Graphen. Jeder Node schickt den Auftrag in die Cloud, wartet und übergibt das Ergebnis an den nächsten Node. Nichts wird auf deine GPU geladen, deshalb laufen Videomodelle, die weit mehr Speicher brauchen, als ein Laptop hat, problemlos von einem Laptop aus.

Das Paket ist popnow-comfyui im Comfy Registry und auf GitHub Open Source. Es bringt einen Node pro Modell mit, einen PopNow Generate-Node, der jedes Modell über seinen Namen annimmt, und einen PopNow LoRA-Node. Diese Seite entspricht der ComfyUI-Seite auf popnow.ai.

In vier Schritten installieren

Node-Paket installieren

Öffne in ComfyUI Manager > Custom Nodes Manager, suche nach PopNow, klicke auf Install und starte ComfyUI neu. Mit der Comfy CLI:

comfy node install popnow-comfyui

Das Paket braucht nichts außer ComfyUI selbst (Python 3.10 oder neuer). Wenn du stattdessen aus dem Quellcode installieren willst, klone popnow-comfyui in ComfyUI/custom_nodes.

API-Schlüssel hinterlegen

Erstelle in der API-Konsole einen Schlüssel, öffne in ComfyUI Settings > PopNow und füge ihn ein. Läufe verbrauchen dein separates API-USD-Guthaben, das bei $0 beginnt. Lade unter API-Abrechnung auf; Website-Credits bezahlen diese Läufe nicht. Alternativ setzt du ihn in der Umgebung, aus der du ComfyUI startest:

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

Bei portablen Windows-Versionen füge set POPNOW_API_KEY=sk-popnow-... zur .bat-Datei hinzu, mit der ComfyUI startet. Starte noch einmal neu, damit die Node-Liste aus deinem Konto geladen wird.

Einen Node hinzufügen

Doppelklicke auf die Arbeitsfläche und gib einen Modellnamen ein (seedance, kling, wan, nano banana, suno …), oder blättere durch PopNow > Video / Image / Audio. PopNow Generate nimmt jede Modell-ID aus Modelle an.

Ausführen

Verbinde Load Image mit dem Bildeingang, falls das Modell ein Bild verlangt, hänge Save Image, Save Video oder Save Audio an und stelle den Prompt in die Warteschlange. Im Vorlagenbrowser von ComfyUI gibt es fertige Graphen unter popnow-comfyui.

Der Einzeldatei-Node

Wenn du lieber eine einzige Datei hast, die du in einer Minute durchlesen kannst, gibt es den Node PopNow Generate des Pakets auch als einzelne Python-Datei. Speichere sie als custom_nodes/popnow_api.py in deinem ComfyUI-Ordner, setze POPNOW_API_KEY wie oben und starte ComfyUI neu. Sie braucht nur requests, Pillow, NumPy und PyTorch, die ComfyUI bereits mitbringt.

Installiere entweder das Paket oder diese Datei, nicht beides: Sie fügen denselben Node hinzu. Wenn du auf das Paket wechselst, lösche custom_nodes/popnow_api.py; gespeicherte Workflows funktionieren weiter.

Eingaben und Ausgaben

Dies sind die Eingaben und Ausgaben von PopNow Generate, identisch im Paket und in der Einzeldatei. Die Modell-Nodes des Pakets zeigen stattdessen die eigenen Felder jedes Modells als Auswahlfelder, Schieberegler und Anschlüsse.

EingabeWas hineingehört
modelEine Modell-ID aus Modelle, zum Beispiel google/nano-banana-2.1/text-to-image oder minimax/h3/image-to-video
promptWas erzeugt werden soll. Für Modelle ohne Prompt leer lassen
optionsDie übrigen Felder des Modells als JSON, etwa {"resolution": "2k"} oder {"duration_seconds": 5}. Die Seite jedes Modells listet sie auf
image (optional)Ein IMAGE von einem anderen Node. Es wird für dich hochgeladen und in das Feld gesetzt, das image_field benennt
image_fieldWelches Feld das Bild bekommt: image_url für die meisten Videomodelle, image_urls für Bildbearbeitung
AusgabeEnthält
imageDas Ergebnis als IMAGE bei Bildmodellen; ein leerer Platzhalter bei Video und Audio
urlDie signierte Datei-URL, gültig für etwa 20 Minuten
pathBei Video und Audio: wo die Datei im Ausgabeordner von ComfyUI gespeichert wurde

Übliche Einstellungen

Zielmodeloptionsimage_field
Text zu Bildgoogle/nano-banana-2.1/text-to-image{"aspect_ratio": "16:9", "resolution": "1k"}—
Lokales Rendering bearbeitengoogle/nano-banana-2.1/edit{"resolution": "2k"}image_urls
Standbild animierenminimax/h3/image-to-video{"duration_seconds": 5, "resolution": "768p"}image_url
Ein Bild hochskalierenpopnow/image-upscaler-v1/upscale{}image_url
Motiv freistellenpopnow/background-remover-v1/edit{}image_url

Ein typischer Hybrid-Graph: Ein Startbild entsteht mit einem lokalen Checkpoint, wird in der Cloud mit einem Bild-zu-Video-Modell animiert, und die gespeicherte MP4 wird mit einem Video-Loader-Node zurückgeladen und lokal hochskaliert oder interpoliert.

Was der Node im Hintergrund tut

Der Node ist eine dünne Hülle über drei REST-Aufrufe; dieselben Aufrufe in anderen Sprachen:

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

Das Hochladen des Eingabebildes ist der dreistufige Ablauf unter Medien; das Ergebnis ist eine popnow://f/…-Referenz, die nur mit Schlüsseln deines eigenen Kontos funktioniert.

Preise

Jeder Lauf verbraucht API-USD zum normalen Modellpreis; der Node fügt nichts hinzu. Nano Banana 2.1 in 1K kostet $0.048 pro Bild, MiniMax H3 in 768p kostet $0.185 für 5 Sekunden. Fehlgeschlagene Läufe werden nicht berechnet. Die Preise aller Modelle stehen auf deren Seite und unter API-Guthaben und Erstattungen; für einen exakten Betrag nutze jobs/quote.

Häufige Fehler

ComfyUI zeigtWarumLösung
No PopNow API key is set (Paket)Kein Schlüssel unter Settings > PopNow oder in der UmgebungFüge den Schlüssel unter Settings > PopNow ein oder setze POPNOW_API_KEY, dann erneut ausführen
Set POPNOW_API_KEY before starting ComfyUI (Einzeldatei)Die Variable ist nicht in der Umgebung von ComfyUIIn derselben Shell oder .bat-Datei setzen, dann neu starten
PopNow 401: …Schlüssel fehlt, ist falsch geschrieben oder widerrufenEinen neuen Schlüssel in der API-Konsole erstellen
PopNow 400: … mit einem Feldnamenoptions enthält ein Feld, das das Modell nicht akzeptiert, oder einen Wert außerhalb des BereichsDie Seite des Modells prüfen; unbekannte Felder werden abgelehnt
PopNow 40201: …Nicht genug API-USDUnter API-Abrechnung aufladen oder Auflösung oder Länge senken
PopNow failed: …Das Modell konnte nicht fertig werden oder hat die Anfrage abgelehntNichts wurde berechnet; Prompt oder Einstellungen ändern
JSONDecodeErroroptions ist kein gültiges JSONDoppelte Anführungszeichen verwenden: {"resolution": "2k"}
Node fehlt in der SuchlistePaket oder Datei ist nicht installiert, oder ComfyUI wurde nicht neu gestartetIm Custom Nodes Manager bzw. im Ordner custom_nodes prüfen, neu starten; Importfehler in der Konsole suchen
Ein Modell von popnow.ai hat keinen NodeDas Paket baut seine Node-Liste beim Start von ComfyUI aus dem Katalog deines KontosComfyUI neu starten oder PopNow Generate mit der Modell-ID verwenden

Ist das ein offizielles Paket im ComfyUI-Registry?

Ja. popnow-comfyui wird von PopNow im Comfy Registry veröffentlicht, daher finden es ComfyUI Manager und comfy node install popnow-comfyui beide. Der Quellcode liegt unter der MIT-Lizenz auf GitHub. Die Einzeldatei auf dieser Seite ist der Node PopNow Generate aus dem Paket, in einer Datei. Siehe SDKs, CLI und Open-Source-Tools.

Funktioniert es mit ComfyUI Desktop und portablen Versionen?

Ja. Es funktioniert überall, wo du Custom Nodes installieren kannst: portabel, Desktop und selbst gehostete Server.

Brauche ich eine GPU?

Nein. Die Generierung läuft auf der Seite von PopNow; dein Rechner schickt nur die Anfrage und empfängt die Datei.

Wie bekomme ich Videoframes zurück in den Graphen?

Der Node speichert das Video im Ausgabeordner von ComfyUI und gibt seinen Pfad zurück. Lade es mit einem Video-Loader-Node, um Frames zu erhalten.

Auf dieser Seite