n8n

Das Base-URL-Feld der OpenAI-Anmeldedaten — https://api.kunavo.com/v1 unter Beibehaltung von /v1 — leitet jeden „OpenAI Chat Model“-Knoten in einem n8n-Workflow an Kunavo weiter; der Modellknoten selbst hat kein Endpunktfeld.

Credentials  →  Create credential  →  OpenAI
  API Key                      sk-kn-...
  Organization ID (optional)   leave empty
  Base URL                     https://api.kunavo.com/v1     <- keep the /v1

Workflow  →  AI Agent or Basic LLM Chain  →  Chat Model: OpenAI Chat Model
  Credential to connect with   the OpenAI credential above
  Model                        ID mode:  claude-sonnet-5
  Use Responses API            on   → POST /v1/responses
                               off  → POST /v1/chat/completions

Schritt für Schritt

1. Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
2. Erstellen Sie in n8n Anmeldedaten vom Typ OpenAI. Tragen Sie den Schlüssel unter API Key ein, lassen Sie Organization ID (optional) leer und ersetzen Sie den Standardwert https://api.openai.com/v1 von Base URL durch https://api.kunavo.com/v1. Speichern Sie die Anmeldedaten.
3. Fügen Sie einen AI Agent- oder Basic LLM Chain-Knoten hinzu und verbinden Sie damit einen OpenAI Chat Model-Unterknoten, der diese Anmeldedaten verwendet. Stellen Sie das Feld Model von From List auf ID um und geben Sie die ID so ein, wie sie unter GET /v1/models aufgeführt ist, zum Beispiel claude-sonnet-5. Die Liste funktioniert ebenfalls, aber eine manuell eingegebene ID macht den Workflow übersichtlicher.
4. Legen Sie fest, ob Use Responses API aktiviert sein soll: Lassen Sie die Option aktiviert, außer ein Tool in Ihrer Kette erwartet Chat Completions oder Sie möchten, dass das n8n-Ausführungsprotokoll eine Chat Completions-Anfrage anzeigt.
5. Führen Sie den Workflow einmal mit einem einzeiligen Prompt aus, bevor Sie ihn mit einem Trigger verknüpfen. Ein 401 bedeutet ein Problem mit dem Schlüssel; ein 404 mit dem Code missing_v1_prefix (oder bei älteren Ausführungen mit einer Meldung, die mit <!DOCTYPE html> beginnt) bedeutet, dass die Basis-URL ihr /v1 verloren hat.

Abgeglichen mit Quellcode der n8n OpenAI-Anmeldedaten im Tag n8n@2.41.4 am 1. Oktober 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in n8n.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Warum sich die Base URL in den Anmeldedaten befindet

In älteren Tutorials wird der Endpunkt im Modellknoten festgelegt. Im veröffentlichten Quellcode ist die Option Base URL im Knoten ab Version 1.1 ausgeblendet. Daher hat ein heute hinzugefügter Knoten kein solches Feld, und maßgeblich ist die Base URL der Anmeldedaten. Weder die Dokumentation zum n8n OpenAI Chat Model noch die Dokumentation zu den Anmeldedaten beschreibt dieses Feld. Im Quellcode steht dagegen die Beschreibung „Standard-Base-URL für die API überschreiben“. Der HTTP Request-Knoten ist ein ganz anderer Weg. Er funktioniert, aber Sie müssten die Anfrage, die ein AI Agent-Knoten für Sie erstellt, von Hand zusammenbauen.

Responses API ein- oder ausgeschaltet

• Ein (Standard bei Knoten 1.3) — Anfragen gehen an /v1/responses. Nur in diesem Modus werden die integrierten Tools des Knotens angezeigt: Web Search, File Search und Code Interpreter. Diese Tools werden von OpenAI gehostet. Niemand hat sie über Kunavo getestet. Erstellen Sie daher keinen Workflow, der von ihnen abhängt, ohne sie vorher auszuprobieren.
• Aus — Anfragen gehen an /v1/chat/completions, das am weitesten verbreitete Format und die Ausweichoption, falls ein Tool-Aufruf im anderen Modus nicht korrekt funktioniert.
• Tools, die Sie an einen AI Agent anhängen, werden dem Modell als Funktionsdefinitionen übermittelt. Dieser Anfragezyklus war nicht Teil dieser Prüfung. Führen Sie daher einen Tool-Aufruf in einem Test-Workflow aus, bevor Sie sich darauf verlassen.

n8n und OpenRouter

n8n enthält einen separaten OpenRouter Chat Model-Knoten mit eigenen OpenRouter-Anmeldedaten. Diese Anmeldedaten haben ein API Key-Feld und eine verborgene, fest auf https://openrouter.ai/api/v1 eingestellte Base URL. Beim Test wird die eigene Route /key von OpenRouter aufgerufen. Der OpenRouter-Knoten kann daher ausschließlich mit OpenRouter kommunizieren. Wenn Sie OpenRouter verwenden möchten, nehmen Sie diesen Knoten mit einem OpenRouter-Schlüssel. Was auf dieser Seite steht, benötigen Sie dafür nicht.

Jeder andere OpenAI-kompatible Endpunkt, Kunavo eingeschlossen, wird wie oben beschrieben über das OpenAI Chat Model und die Base URL der OpenAI-Anmeldedaten angebunden. Entscheiden Sie anhand der tatsächlichen Unterschiede — welche Modelle Sie benötigen, wie Sie bezahlen möchten und ob Sie ein Guthaben für n8n und Ihre anderen Tools gemeinsam nutzen möchten —, nicht anhand des Knotens. Den Kunavo betreffenden Teil dieses Vergleichs finden Sie unter Kunavo im Vergleich zu OpenRouter.

Die Kosten für einen unbeaufsichtigten Workflow begrenzen

• Für Max Retries gilt standardmäßig der Wert 2, für Timeout 60000 ms. Bei einer Zeitüberschreitung wird die Anfrage erneut gesendet. Jeder erneute Versuch verursacht Kosten für eine neue Anfrage.
• Legen Sie bei Knoten, die pro Element ausgeführt werden, Maximum Number of Tokens fest. In einer Schleife über 1,000 Zeilen vervielfachen sich dadurch die Kosten eines einzelnen Aufrufs.
• Verwenden Sie für jeden Produktions-Workflow einen eigenen Kunavo-Schlüssel. So zeigt die Nutzungsseite, welcher Workflow welche Kosten verursacht hat, und Sie können einen Schlüssel widerrufen, ohne die anderen anzutasten.

So sehen die Fehler aus

• „401 Fehlender oder ungültiger API-Schlüssel“ — die Base URL ist richtig, aber der Schlüssel ist es nicht. Reproduziert mit 2.41.4.
• „404 <!DOCTYPE html>…“, von LangChain als MODEL_NOT_FOUND erfasst — irreführend: Das Modell ist in Ordnung. In der Base URL fehlt /v1, sodass die Anfrage auf der Website landete. Reproduziert mit 2.41.4.
• Eine JSON-Meldung, dass das Modell nicht verfügbar ist — die Modell-ID stimmt nicht exakt mit GET /v1/models überein.