ComfyUI-Nodes

Das SpicyAPI-Node-Paket für ComfyUI macht jedes Bild-, Video- und Audiomodell von SpicyAPI zu einem ComfyUI-Node: mehr als 180 Stück, dazu ein SpicyAPI Chat-Node für Textmodelle und ein SpicyAPI LoRA-Node. Die Modelle laufen auf den Servern von SpicyAPI. Sie brauchen also eine Internetverbindung und einen API-Schlüssel, aber weder eine Grafikkarte noch heruntergeladene Gewichte. Jeder Node zeigt seinen Preis, bevor er läuft, und gibt nach dem Lauf aus, was dieser gekostet hat.

Das Paket ist kostenlos und quelloffen (MIT) unter github.com/spicyapi-ai/comfyui-spicyapi. Es installiert nichts außer ComfyUI selbst.

Ist das das richtige Werkzeug?

Alle nutzen dasselbe Konto, dasselbe Guthaben, dieselben Modelle und dieselben Preise.

Bevor Sie anfangen

• Ein aktuelles ComfyUI. Die Nodes nutzen die V3-Node-API von ComfyUI und wurden mit ComfyUI 0.39 getestet. Jede Installation, die Ordner aus custom_nodes lädt, funktioniert: die Desktop-App, die Portable-Version oder eine manuelle Installation.
• Ein API-Schlüssel. Legen Sie ihn in der Konsole an; er beginnt mit sk-spicy-. Wenn Sie noch kein Konto haben, siehe Konto einrichten.
• Guthaben. Jeder Lauf wird von Ihrem vorausbezahlten US-Dollar-Guthaben abgebucht. Siehe Abrechnung.
• Zugriff auf api.spicyapi.ai von dem Rechner aus, auf dem ComfyUI läuft. Ein über HTTPS_PROXY gesetzter Proxy wird berücksichtigt.

Installieren

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

API-Schlüssel eintragen

Öffnen Sie Settings > SpicyAPI > API key und fügen Sie Ihren Schlüssel ein. Ein Hinweis bestätigt, dass der Schlüssel funktioniert, und zeigt Ihr verfügbares Guthaben. Starten Sie ComfyUI danach einmal neu: Die Node-Liste wird beim Start von ComfyUI aus dem Live-Katalog Ihres Kontos aufgebaut, und solange kein Schlüssel gesetzt ist, gilt die mit dem Release mitgelieferte Liste.

Der Schlüssel liegt in einer Datei im ComfyUI-Benutzerordner (user/spicyapi/config.json), die nur Ihr eigenes Benutzerkonto lesen kann. Er wird nie in eine Workflow-Datei oder in die Metadaten eines von ComfyUI gespeicherten Bildes geschrieben. Wenn Sie eines von beiden weitergeben, geben Sie also Ihren Schlüssel nicht mit weiter. Das Einstellungsfeld zeigt danach nur noch die letzten vier Zeichen. Um den Schlüssel zu entfernen, leeren Sie das Feld.

Auf einem Server oder in einem Container setzen Sie stattdessen die Umgebungsvariable SPICY_API_KEY. Sie hat Vorrang vor dem Einstellungsfeld.

Ersten Node ausführen

Lieber mit einem fertigen Graphen starten? Der Vorlagen-Browser von ComfyUI listet die Beispiele des Pakets unter comfyui-spicyapi: Text zu Bild, Bild zu Video, ein Chatmodell, das den Prompt für ein Bildmodell schreibt, Text zu Sprache und LoRA.

Ausgearbeitete Beispiele mit ihren echten Ergebnissen, Preisen und Laufzeiten sowie die Live-Liste der unzensierten Nodes finden Sie auf der ComfyUI-Seite auf spicyapi.ai.

So funktionieren die Nodes

Jeder Node wird aus dem veröffentlichten Eingabeschema seines Modells erzeugt, demselben, gegen das auch die API Anfragen prüft. Ein Node bietet deshalb nie eine Option an, die das Modell ablehnen würde.

Ein Dropdown auf model default oder eine Zahl auf -1 wird aus der Anfrage weggelassen, sodass das Modell seinen eigenen Standardwert verwendet.

Die Ausgaben sind gewöhnliche ComfyUI-Werte, die jeder andere Node übernehmen kann:

• Bildmodelle liefern IMAGE. Die Hintergrundentfernung liefert zusätzlich eine alpha-Maske.
• Videomodelle liefern VIDEO, dazu das letzte Bild des Clips als IMAGE, wenn return_last_frame eingeschaltet ist.
• Audiomodelle liefern AUDIO. Ein Modell, das mehrere Clips zurückgibt, etwa Suno, liefert sie als einen Stapel, und Save Audio schreibt je eine Datei.
• Die Transkription liefert STRING.
• Jeder Node gibt außerdem seine task_id aus, für die Logs der Konsole oder eine Support-Anfrage.

Chat- und LoRA-Nodes

SpicyAPI Chat sendet einen Prompt, optionale Systemanweisungen und optionale Bilder an ein beliebiges Textmodell bei SpicyAPI und gibt die Antwort als STRING zurück. Verbinden Sie ihn mit dem prompt eines Bild- oder Video-Nodes, damit ein Sprachmodell die Prompts direkt im Graphen schreibt oder verfeinert. Ein Modell, das keine Bilder lesen kann, lehnt Bildeingaben ab, ohne dass etwas berechnet wird.

SpicyAPI LoRA fügt eine LoRA-Gewichtsdatei hinzu, angegeben als direkter Download-Link auf eine .safetensors-Datei, mit einer Stärke von 0 bis 4. Mehrere davon hintereinander geschaltet werden gestapelt; verbinden Sie den letzten mit dem Eingang loras eines LoRA-Modell-Nodes (deren Namen enden auf LoRA). Der Link muss sich ohne Anmeldung öffnen lassen.

Was ein Lauf kostet

• Das Preisschild an jedem Node zeigt den aktuellen Preis des Modells für die gewählten Optionen, zum Beispiel $0.0525/s für Video oder $0.01/image, und ändert sich mit Ihren Einstellungen.
• Jeder Lauf bekommt vorab eine Kostenschätzung. Legen Sie unter Settings > SpicyAPI > Max cost per run eine Obergrenze in US-Dollar fest. Ein Lauf, dessen Kostenschätzung darüber liegt, wird gestoppt, bevor etwas berechnet wird.
• Der endgültige Betrag erscheint am Node, sobald der Lauf beendet ist. Fehlgeschlagene Läufe werden nicht berechnet, außer bei Modellen, deren Seite angibt, dass Ablehnungen berechnet werden. Siehe Abrechnung.
• Seeds stehen zunächst auf fixed. Wenn Sie denselben Graphen zweimal einreihen, wird das erste Ergebnis wiederverwendet, statt erneut zu zahlen. Stellen Sie control after generate auf randomize, um bei jedem Lauf ein neues Ergebnis zu erhalten, und damit auch eine neue Berechnung.
• Abbrechen beendet das Warten, nicht den Auftrag. Ein Lauf, den Sie in ComfyUI abbrechen, läuft bei SpicyAPI weiter, wird bei Erfolg berechnet, und sein Ergebnis liegt in den Logs der Konsole.

Ergebnisse bleiben bis zu 14 Tage in Ihrer Konsole, oder kürzer, wenn Ihr Konto sie kürzer aufbewahrt. Nutzen Sie die Save-Nodes von ComfyUI, um eine eigene Kopie zu behalten. Siehe Datenaufbewahrung und Löschung.

Fehlerbehebung

Fehler von SpicyAPI enden mit einer request_id oder einer Task-ID. Nennen Sie sie dem Support, dann lässt sich die Anfrage genau finden. Die Fehlercodes werden unter Fehler erklärt.