PopNowDocs API
Intégrations
Contenu principal

Nœud ComfyUI pour la génération dans le cloud

Exécutez dans ComfyUI les modèles IA cloud d’image, de vidéo et d’audio avec le pack officiel de nœuds PopNow depuis ComfyUI Manager, ou un seul fichier de nœud. Ni GPU ni téléchargement de modèles ; étapes d’installation, entrées, tarifs et solutions aux erreurs.

Le pack officiel de nœuds PopNow place chaque modèle d’image, de vidéo et d’audio de PopNow dans un graphe ComfyUI. Chaque nœud envoie la tâche dans le cloud, attend le résultat et le transmet au nœud suivant. Rien n’est téléchargé sur votre GPU : les modèles vidéo qui demandent bien plus de mémoire qu’un ordinateur portable n’en a fonctionnent donc sans difficulté depuis un portable.

Le pack est popnow-comfyui sur le Comfy Registry, en open source sur GitHub. Il ajoute un nœud par modèle, un nœud PopNow Generate qui accepte n’importe quel modèle par son nom, et un nœud PopNow LoRA. Cette page correspond à la page ComfyUI de popnow.ai.

Installer en quatre étapes

Installer le pack de nœuds

Dans ComfyUI, ouvrez Manager > Custom Nodes Manager, recherchez PopNow, cliquez sur Install et redémarrez ComfyUI. Avec la CLI Comfy :

comfy node install popnow-comfyui

Le pack n’exige rien d’autre que ComfyUI lui-même (Python 3.10 ou plus récent). Pour l’installer depuis les sources, clonez popnow-comfyui dans ComfyUI/custom_nodes.

Ajouter votre clé API

Créez une clé dans la console API, ouvrez Settings > PopNow dans ComfyUI et collez-la. Les exécutions dépensent votre solde API séparé en USD, initialement $0. Approvisionnez-le dans Facturation API ; les crédits du site ne paient pas ces exécutions. Vous pouvez aussi définir la clé dans l’environnement depuis lequel vous lancez ComfyUI :

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

Sur les versions portables Windows, ajoutez set POPNOW_API_KEY=sk-popnow-... au fichier .bat qui démarre ComfyUI. Redémarrez une fois de plus pour que la liste des nœuds provienne de votre compte.

Ajouter un nœud

Double-cliquez sur le canevas et tapez le nom d’un modèle (seedance, kling, wan, nano banana, suno …), ou parcourez PopNow > Video / Image / Audio. PopNow Generate accepte n’importe quel identifiant de modèle de Modèles.

Lancer la file

Reliez Load Image à l’entrée image si le modèle en demande une, connectez Save Image, Save Video ou Save Audio, puis mettez le prompt en file. Le navigateur de modèles de ComfyUI propose des graphes prêts à l’emploi sous popnow-comfyui.

Le nœud en un seul fichier

Si vous préférez un fichier unique que vous pouvez lire en une minute, le nœud PopNow Generate du pack existe aussi sous forme d’un seul fichier Python. Enregistrez-le sous custom_nodes/popnow_api.py dans votre dossier ComfyUI, définissez POPNOW_API_KEY comme ci-dessus et redémarrez ComfyUI. Il n’utilise que requests, Pillow, NumPy et PyTorch, que ComfyUI embarque déjà.

Installez le pack ou ce fichier, pas les deux : ils ajoutent le même nœud. Quand vous passez au pack, supprimez custom_nodes/popnow_api.py ; les workflows enregistrés continuent de fonctionner.

Entrées et sorties

Ce sont les entrées et sorties de PopNow Generate, identiques dans le pack et dans le fichier unique. Les nœuds par modèle du pack affichent à la place les champs propres à chaque modèle, sous forme de listes déroulantes, de curseurs et de connecteurs.

EntréeCe qu’il faut y mettre
modelUn identifiant de modèle de Modèles, par exemple google/nano-banana-2.1/text-to-image ou minimax/h3/image-to-video
promptCe qu’il faut générer. Laissez-le vide pour les modèles qui n’acceptent pas de prompt
optionsLes autres champs du modèle, en JSON, comme {"resolution": "2k"} ou {"duration_seconds": 5}. La page de chaque modèle les liste
image (facultatif)Une IMAGE provenant d’un autre nœud. Elle est envoyée pour vous et placée dans le champ nommé par image_field
image_fieldLe champ qui reçoit l’image : image_url pour la plupart des modèles vidéo, image_urls pour la retouche d’image
SortieContenu
imageLe résultat sous forme de IMAGE pour les modèles d’image ; un espace réservé vide pour la vidéo et l’audio
urlL’URL signée du fichier, valable une vingtaine de minutes
pathPour la vidéo et l’audio : l’emplacement où le fichier a été enregistré dans le dossier de sortie de ComfyUI

Configurations courantes

Objectifmodeloptionsimage_field
Texte vers imagegoogle/nano-banana-2.1/text-to-image{"aspect_ratio": "16:9", "resolution": "1k"}—
Retoucher un rendu localgoogle/nano-banana-2.1/edit{"resolution": "2k"}image_urls
Animer une image fixeminimax/h3/image-to-video{"duration_seconds": 5, "resolution": "768p"}image_url
Agrandir une imagepopnow/image-upscaler-v1/upscale{}image_url
Détourer le sujetpopnow/background-remover-v1/edit{}image_url

Un graphe hybride type : créez une image de départ avec un checkpoint local, animez-la dans le cloud avec un modèle image-vers-vidéo, puis rechargez le MP4 enregistré avec un nœud de chargement vidéo et agrandissez-le ou interpolez-le localement.

Ce que fait le nœud en coulisses

Le nœud n’est qu’une fine enveloppe autour de trois appels REST ; voici les mêmes appels dans d’autres langages :

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

L’envoi de l’image d’entrée suit le flux en trois étapes décrit dans Médias ; le résultat est une référence popnow://f/… qui ne fonctionne qu’avec les clés de votre propre compte.

Tarifs

Chaque exécution dépense des USD API au tarif habituel du modèle ; le nœud n’ajoute rien. Nano Banana 2.1 en 1K coûte $0.048 par image ; MiniMax H3 en 768p coûte $0.185 pour 5 secondes. Les exécutions échouées ne sont pas facturées. Les prix figurent sur la page de chaque modèle et dans Solde API et remboursements ; utilisez jobs/quote pour un montant exact.

Erreurs courantes

ComfyUI afficheCauseSolution
No PopNow API key is set (pack)Aucune clé dans Settings > PopNow ni dans l’environnementCollez la clé dans Settings > PopNow, ou définissez POPNOW_API_KEY, puis relancez
Set POPNOW_API_KEY before starting ComfyUI (fichier unique)La variable n’est pas dans l’environnement de ComfyUIDéfinissez-la dans le même shell ou le même fichier .bat, puis redémarrez
PopNow 401: …Clé manquante, mal saisie ou révoquéeCréez une nouvelle clé dans la console API
PopNow 400: … avec un nom de champoptions contient un champ que le modèle n’accepte pas, ou une valeur hors plageConsultez la page du modèle ; les champs inconnus sont refusés
PopNow 40201: …Pas assez d’USD APIApprovisionnez Facturation API, ou réduisez la résolution ou la durée
PopNow failed: …Le modèle n’a pas pu aller au bout, ou a refusé la requêteRien n’a été débité ; modifiez le prompt ou les réglages
JSONDecodeErroroptions n’est pas du JSON valideUtilisez des guillemets doubles : {"resolution": "2k"}
Nœud absent de la liste de rechercheLe pack ou le fichier n’est pas installé, ou ComfyUI n’a pas été redémarréVérifiez Custom Nodes Manager ou le dossier custom_nodes, redémarrez, et cherchez les erreurs d’import dans la console
Un modèle de popnow.ai n’a pas de nœudLe pack construit sa liste de nœuds à partir du catalogue de votre compte au démarrage de ComfyUIRedémarrez ComfyUI, ou utilisez PopNow Generate avec l’identifiant du modèle

S’agit-il d’un paquet officiel du registre ComfyUI ?

Oui. popnow-comfyui est publié par PopNow sur le Comfy Registry ; ComfyUI Manager et comfy node install popnow-comfyui le trouvent tous les deux. Le code source est sur GitHub, sous licence MIT. Le nœud en fichier unique de cette page est son nœud PopNow Generate, réuni en un seul fichier. Voir SDK, CLI et outils open source.

Fonctionne-t-il avec ComfyUI Desktop et les versions portables ?

Oui. Il fonctionne partout où vous pouvez installer des nœuds personnalisés : version portable, Desktop et serveurs auto-hébergés.

Ai-je besoin d’un GPU ?

Non. La génération s’exécute chez PopNow ; votre machine envoie seulement la requête et reçoit le fichier.

Comment ramener les images d’une vidéo dans le graphe ?

Le nœud enregistre la vidéo dans le dossier de sortie de ComfyUI et renvoie son chemin. Chargez-la avec un nœud de chargement vidéo pour en obtenir les images.

Sur cette page