n8n

n8n ist ein Werkzeug zur Workflow-Automatisierung. SpicyAPI stellt ihm Bild-, Video-, Audio- und Chatmodelle hinter einer API und einem vorausbezahlten Guthaben bereit. Es gibt drei Wege, sie anzubinden, und sie lassen sich in einem Workflow mischen:

Alle drei nutzen dasselbe Konto, denselben Schlüssel, dieselben Modelle und dieselben Preise. Bei Medien prüfen die Node und die HTTP-Request-Vorlagen den Preis vor dem Absenden. Wird dieselbe angenommene Medienanfrage mit ihrem ursprünglichen Idempotency-Key erneut gesendet, kommt der bestehende Task zurück.

Für einen ersten Bild-Workflow lesen Sie den Leitfaden für NSFW-Bild-Workflows mit n8n: Modellauswahl, Bearbeitung einer Referenz, ein erstes Porträt und Kostenbeispiele. Die Schritte darunter verbinden den Workflow mit Ihrer n8n-Instanz.

Bevor Sie anfangen

• Ein API-Schlüssel. Erstellen Sie ihn in der Konsole; er beginnt mit sk-spicy-. Falls Sie noch kein Konto haben, siehe Konto einrichten.
• Guthaben. Laden Sie vor der ersten Generierung im Bereich Billing der Konsole Guthaben auf. n8n-Workflows, Studio und API nutzen dasselbe Kontoguthaben. Wie die Abrechnung erfolgt, steht unter Abrechnung.
• Ein Schlüssel pro Automatisierung. Workflows können weit häufiger laufen, als ein Mensch klickt. Erstellen Sie für n8n einen eigenen Schlüssel und setzen Sie ein Tages- oder Monatslimit darauf, damit ein Fehler in einer Schleife eine Obergrenze hat. Siehe Authentifizierung.
• n8n kann api.spicyapi.ai erreichen. Die Aufrufe macht der n8n-Server, nicht Ihr Browser.

Option 1: die SpicyAPI-Community-Node

Die Node ist quelloffen (MIT) unter github.com/spicyapi-ai/n8n-nodes-spicyapi und auf npm als @spicyapi/n8n-nodes-spicyapi veröffentlicht. Sie hat keine Laufzeitabhängigkeiten und spricht nur mit api.spicyapi.ai.

Andere npm-Pakete haben ähnliche Namen, gehören aber zu fremden Diensten. Dieses hier ist das Paket namens @spicyapi/n8n-nodes-spicyapi, und seine Credential heißt SpicyAPI (spicyapi.ai) API.

Installieren

cd ~/.n8n/nodes
npm install @spicyapi/n8n-nodes-spicyapi

Operationen

Bilder, Video und Audio erzeugen

Die drei Generate-Operationen haben dieselben Felder:

1. Model. Wählen Sie aus der Liste, die die Modelle der gewählten Ressource mit ihrem Startpreis zeigt, oder geben Sie eine Modell-ID von Hand ein. Alle Modelle und ihre Parameter sind unter spicyapi.ai/models aufgeführt.
2. Prompt. Die Haupttexteingabe des Modells. Bei Sprachmodellen ist das der zu sprechende Text. Lassen Sie sie bei Modellen ohne Prompt leer, etwa bei Upscalern.
3. Media Inputs. Bilder, Videos oder Audio, die das Modell liest. Wählen Sie das Feld (die Liste zeigt die Dateieingaben des gewählten Modells) und verwenden Sie dann ein Binärfeld aus der vorherigen Node oder eine URL. Binärdateien werden automatisch zu SpicyAPI hochgeladen. Fügen Sie mehrere Eingaben für dasselbe Feld hinzu, um Listenfelder wie Referenzbilder zu füllen.
4. Model Parameters. Ein aus dem Schema des gewählten Modells erzeugtes Formular: Seitenverhältnis, Auflösung, Dauer, Seed und so weiter. Leer gelassene Felder werden nicht gesendet, sodass das Modell seinen eigenen Standardwert verwendet.
5. Additional Parameters (JSON). Alle weiteren Eingabefelder als JSON-Objekt. Sie überschreiben die obigen Felder.

Die Ausgabe enthält den Task-Datensatz (taskId, state, cost, settled, output). Mit eingeschaltetem Download Output, was die Voreinstellung ist, werden die Dateien zusätzlich als Binärdaten in data, data_1 und so weiter angehängt. Die Links in output.assets[].url laufen nach etwa 20 Minuten ab; die Binärkopien nicht.

Große Videos werden im Arbeitsspeicher gehalten, solange n8n Binärdaten nicht auf der Festplatte speichert. Setzen Sie bei selbst gehostetem n8n N8N_DEFAULT_BINARY_DATA_MODE=filesystem, wenn Sie mit Video arbeiten.

Kostenkontrolle und Wiederholungen

• Jedes Item wird zuerst bepreist. Die Node holt ein Angebot ein. Liegt es über Max Cost per Item (USD), standardmäßig $2, bricht sie mit einem Fehler ab, bevor etwas erstellt wird, und es wird nichts berechnet. Setzen Sie das Limit auf 0, um es zu entfernen.
• Die Aufgabe wird mit dem angebotenen Preis erstellt. Ändert sich der Preis zwischen Angebot und Einreichung, holt die Node erneut ein Angebot ein, prüft das Limit erneut und reicht neu ein.
• Wiederholungen berechnen nicht doppelt. Siehe Kostenlimits und Wiederholungen.

Lang laufende Aufgaben

Die Optionen und wann Sie welche einsetzen, stehen unter Lang laufende Videoaufgaben.

Option 2: HTTP-Request-Vorlagen

Zwei importierbare Workflows verwenden nur eingebaute n8n-Nodes und laufen daher auf selbst gehostetem n8n und auf n8n Cloud, ohne Community-Node. Sie liegen im examples-Ordner des Repositorys der Node.

Wie die Bild-Vorlage aufgebaut ist

Dieselben Schritte funktionieren für jedes Medienmodell, sodass Sie das Muster in Ihren eigenen Workflow kopieren können.

Die Formen von Anfragen und Antworten stehen unter Tasks, Angebote und Kompatibilität und Medien-Ein- und Ausgaben. Dateien, die ein Modell liest, etwa ein Startbild, können eine öffentliche URL oder eine hochgeladene spicy://-Datei sein.

Option 3: Chatmodelle in AI Agent und anderen KI-Nodes

Der Chat-Endpunkt von SpicyAPI ist OpenAI-kompatibel, daher können die eigenen OpenAI-Nodes von n8n ihn nutzen. Dafür brauchen Sie die Community-Node nicht, und es funktioniert auf n8n Cloud.

https://api.spicyapi.ai/v1

Was Sie wissen sollten:

• Die Modellliste enthält Bild- und Videomodelle. Bei einer eigenen Base URL zeigt n8n alles, was /v1/models zurückgibt, und die Liste von SpicyAPI umfasst alle Modelle. Wählen Sie eines, das auf /chat endet, oder tippen Sie die ID im Expression-Modus ein. Bild- und Videomodelle sind keine Chatmodelle und scheitern in einem Agent.
• Use Responses API. Neuere Versionen der Node OpenAI Chat Model können Anfragen an /v1/responses statt an /v1/chat/completions senden. SpicyAPI unterstützt /v1/responses, aber nicht previous_response_id. Scheitert eine Agent-Anfrage bei eingeschalteter Responses API, schalten Sie Use Responses API in der Node aus.
• Sampling-Einstellungen. Setzen Sie eine Option, die das Modell nicht deklariert, etwa temperature bei einem Reasoning-Modell, ignoriert SpicyAPI sie, statt zu scheitern, und listet die ignorierten Namen im Antwort-Header X-Spicy-Ignored-Params auf; ein Wert außerhalb des Bereichs des Modells wird auf den nächstliegenden zulässigen Wert geändert und in X-Spicy-Adjusted-Params aufgeführt. Andere nicht deklarierte Felder liefern weiterhin 400.
• Tools und JSON-Ausgabe hängen vom Modell ab. Prüfen Sie die supported_parameters des Modells in /v1/models.
• Reasoning-Modelle rechnen Reasoning-Tokens auf max_tokens an. Bei einem sehr kleinen Wert, etwa 20, kann ein Reasoning-Modell das gesamte Budget für das Nachdenken verbrauchen und keinen Text zurückgeben (upstream_failed: „the output budget was spent on reasoning“). Erhöhen Sie max_tokens oder senken Sie reasoning_effort. Die Werte für reasoning_effort unterscheiden sich je Modell.
• Streaming und Kosten. Chat wird nach dem Aufruf nach Tokens abgerechnet. Die Seite Text und Streaming hat die Details, und Chat-Rezepte enthält Anfragebeispiele.

Kostenlimits und Wiederholungen

Limits für Ausgaben

• Verwenden Sie einen eigenen Schlüssel für n8n mit einem Tages- oder Monatslimit in der Konsole und einer Modell-Allowlist, falls der Workflow nur wenige Modelle braucht. Ist ein Limit erreicht, scheitert der Aufruf mit 40202, und dafür wird nichts berechnet.
• Holen Sie bei Medienmodellen zuerst ein Angebot ein. Die Node erledigt das für Sie; die Vorlagen machen es mit den Nodes Get Quote und If. Das Angebot ist der genaue Preis dieser Anfrage, einschließlich Zusätzen wie Gebühren pro Referenzbild, daher ist eine Preisprüfung auf Basis eines Angebots verlässlich und eine auf Basis der Katalogtabelle nicht.
• Bei gewöhnlichen Fehlschlägen und abgelaufenen Tasks wird die Reservierung vollständig freigegeben. Bestimmte Inhaltsablehnungen werden nur berechnet, wenn die Modellseite dies ausdrücklich angibt. Den endgültigen Betrag zeigen settled und cost; siehe Abrechnung.

Warum eine Wiederholung nicht doppelt berechnet

Jeder Aufruf, der eine Aufgabe erstellt, trägt einen Idempotency-Key. Trifft derselbe Schlüssel mit derselben Anfrage erneut ein, gibt SpicyAPI die bereits erstellte Aufgabe zurück, statt eine zweite zu erstellen, sodass keine zweite Reservierung und keine zweite Abbuchung erfolgt. Das ist in n8n wichtig, weil eine Anfrage ohne Ihr Zutun zweimal gesendet werden kann: durch Retry On Fail an einer Node oder durch ein Timeout, bei dem die erste Anfrage tatsächlich durchgegangen ist.

• Die Community-Node bildet den Schlüssel aus der Ausführung, der Node, dem Item und dessen Eingabe. Eine Wiederholung der Node verwendet denselben Schlüssel. Eine neue Ausführung, eine geänderte Eingabe oder ein weiterer Durchlauf einer Schleife ist neue Arbeit und bekommt einen neuen Schlüssel.
• Die Vorlagen bilden ihn aus der Ausführungs-ID und dem Item-Index, zum Beispiel n8n-<execution id>-<item index>. Wenn Sie das Muster in eine Schleife kopieren, nehmen Sie den Schleifenzähler in den Schlüssel auf, sonst liefert jeder Durchlauf die Aufgabe des ersten Durchlaufs zurück.
• Verwenden Sie keinen Zufallswert, der sich bei jedem Versuch ändert, etwa $now: Er lässt jede Wiederholung wie neue Arbeit aussehen.

Mehr unter Idempotenz.

Lang laufende Videoaufgaben

Bild- und Audiomodelle sind meist innerhalb einer Anfrage fertig. Video kann Minuten dauern. Sie haben drei Wege, damit umzugehen, vom einfachsten bis zum schonendsten für n8n:

Hört die Node auf zu warten, läuft die Aufgabe bei SpicyAPI weiter und wird bei Erfolg berechnet. Holen Sie sie später mit Task > Get ab; reichen Sie sie nicht erneut ein. Sie finden sie auch unter Logs in der Konsole.

Ergebnisse werden nur begrenzte Zeit aufbewahrt, und Download-Links gelten etwa 20 Minuten. Speichern Sie die Dateien im Workflow, zum Beispiel in einem Cloud-Speicher, wenn Sie sie länger brauchen. Siehe Aufbewahrung.

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 sind unter Fehler erklärt, und eine umfassendere Checkliste finden Sie unter Fehlerbehebung.

Die Nutzung der Modelle unterliegt den SpicyAPI-Nutzungsbedingungen und den Bedingungen der von Ihnen betriebenen n8n-Edition.