Nœuds ComfyUI

Le pack de nœuds SpicyAPI pour ComfyUI transforme chaque modèle d’image, de vidéo et d’audio de SpicyAPI en nœud ComfyUI : plus de 180 au total, auxquels s’ajoutent un nœud SpicyAPI Chat pour les modèles de texte et un nœud SpicyAPI LoRA. Les modèles s’exécutent sur les serveurs de SpicyAPI : il vous faut une connexion internet et une clé API, mais ni carte graphique ni poids de modèle à télécharger. Chaque nœud affiche son prix avant de s’exécuter et indique ce que l’exécution a coûté une fois terminée.

Le pack est gratuit et open source (MIT) sur github.com/spicyapi-ai/comfyui-spicyapi. Il n’installe rien d’autre que ComfyUI lui-même.

Est-ce le bon outil ?

Tous partagent le même compte, le même solde, les mêmes modèles et les mêmes prix.

Avant de commencer

• Une version récente de ComfyUI. Les nœuds utilisent l’API de nœuds V3 de ComfyUI et ont été testés avec ComfyUI 0.39. Toute installation qui charge les dossiers de custom_nodes convient : l’application de bureau, la version portable ou une installation manuelle.
• Une clé API. Créez-en une dans la console ; elle commence par sk-spicy-. Si vous n’avez pas encore de compte, voir Préparer votre compte.
• Un solde. Chaque exécution est payée sur votre solde prépayé en dollars américains. Voir Facturation.
• L’accès à api.spicyapi.ai depuis la machine qui exécute ComfyUI. Un proxy défini via HTTPS_PROXY est pris en compte.

Installation

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Ajouter votre clé API

Ouvrez Settings > SpicyAPI > API key et collez votre clé. Une notification confirme que la clé fonctionne et affiche votre solde disponible. Redémarrez ensuite ComfyUI une fois : la liste des nœuds est construite à partir du catalogue en direct de votre compte au démarrage de ComfyUI, et tant qu’aucune clé n’est définie, la liste fournie avec la version est utilisée.

La clé est enregistrée dans un fichier du dossier utilisateur de ComfyUI (user/spicyapi/config.json) que seul votre compte peut lire. Elle n’est jamais écrite dans un fichier de workflow ni dans les métadonnées d’une image enregistrée par ComfyUI : partager l’un ou l’autre ne partage donc pas votre clé. Ensuite, le champ des réglages n’affiche que les quatre derniers caractères. Pour supprimer la clé, videz le champ.

Sur un serveur ou dans un conteneur, définissez plutôt la variable d’environnement SPICY_API_KEY. Elle est prioritaire sur le champ des réglages.

Lancer votre premier nœud

Vous préférez partir d’un graphe qui fonctionne ? Le navigateur de modèles de ComfyUI liste les exemples du pack sous comfyui-spicyapi : texte vers image, image vers vidéo, un modèle de chat qui rédige le prompt d’un modèle d’image, synthèse vocale et LoRA.

Des exemples concrets avec leurs vrais résultats, prix et temps d’exécution, ainsi que la liste à jour des nœuds non censurés, sont sur la page ComfyUI de spicyapi.ai.

Comment fonctionnent les nœuds

Chaque nœud est généré à partir du schéma d’entrée publié de son modèle, celui-là même que l’API utilise pour valider les requêtes : un nœud ne propose donc jamais une option que le modèle refuserait.

Une liste déroulante réglée sur model default, ou un nombre réglé sur -1, est omise de la requête : le modèle applique alors sa valeur par défaut.

Les sorties sont des valeurs ComfyUI ordinaires, que n’importe quel autre nœud peut utiliser :

• Les modèles d’image renvoient IMAGE. La suppression d’arrière-plan renvoie aussi un masque alpha.
• Les modèles vidéo renvoient VIDEO, plus la dernière image du clip en IMAGE quand return_last_frame est activé.
• Les modèles audio renvoient AUDIO. Un modèle qui renvoie plusieurs clips, comme Suno, les renvoie en un seul lot et Save Audio écrit un fichier par clip.
• La transcription renvoie STRING.
• Chaque nœud renvoie aussi son task_id, utile pour le Journal de la console ou une demande d’assistance.

Nœuds Chat et LoRA

SpicyAPI Chat envoie un prompt, des instructions système facultatives et des images facultatives à n’importe quel modèle de texte de SpicyAPI, et renvoie la réponse sous forme de STRING. Reliez-le au prompt d’un nœud d’image ou de vidéo pour qu’un modèle de langage écrive ou affine les prompts au sein du graphe. Un modèle qui ne lit pas les images refuse une entrée image, sans rien facturer.

SpicyAPI LoRA ajoute un fichier de poids LoRA, fourni sous forme de lien de téléchargement direct vers un fichier .safetensors, avec une intensité de 0 à 4. Chaînez-en plusieurs pour les cumuler, puis reliez le dernier à l’entrée loras d’un nœud de modèle LoRA (leurs noms se terminent par LoRA). Le lien doit s’ouvrir sans connexion.

Ce que coûte une exécution

• Le badge de chaque nœud affiche le tarif actuel du modèle pour les options choisies, par exemple $0.0525/s pour une vidéo ou $0.01/image, et change quand vous modifiez ces options.
• Chaque exécution fait d’abord l’objet d’un devis. Sous Settings > SpicyAPI > Max cost per run, fixez un plafond en dollars américains. Une exécution dont le devis dépasse ce plafond s’arrête avant toute facturation.
• Le montant final s’affiche sur le nœud à la fin de l’exécution. Les exécutions échouées ne sont pas facturées, sauf pour les modèles dont la page indique que les refus sont facturés. Voir Facturation.
• Les seeds démarrent sur fixed. Mettre deux fois le même graphe en file réutilise le premier résultat au lieu de payer à nouveau. Réglez control after generate sur randomize pour obtenir un nouveau résultat, et une nouvelle facturation, à chaque exécution.
• Annuler interrompt l’attente, pas la tâche. Une exécution annulée dans ComfyUI se poursuit chez SpicyAPI, est facturée si elle réussit, et son résultat se trouve dans le Journal de la console.

Les résultats restent dans votre console pendant 14 jours au plus, ou moins si votre compte les conserve moins longtemps. Utilisez les nœuds Save de ComfyUI pour garder votre propre copie. Voir Conservation et destruction.

Dépannage

Les erreurs de SpicyAPI se terminent par un request_id ou un identifiant de tâche. Communiquez-le à l’assistance pour que la requête soit retrouvée exactement. Les codes d’erreur sont expliqués dans Erreurs.