Wichtige Einstellungen
Voraussetzungen
- Die aktuelle Version des Tools ist installiert
- Ein BetterToken API Key: Registriere dich und erhalte einen
- Eine Model ID aus der model plaza
Zusätzliche Anforderungen
- Eine n8n-Cloud- oder selbst gehostete Instanz
Behalte
/v1 am Ende der Base URL. Füge nicht /chat/completions oder /responses hinzu; n8n hängt die vom Knoten erforderliche Route an.Installation
Installiere oder öffne n8n und fahre dann mit der manuellen Einrichtung unten fort.Manuelle Einrichtung
Führe diese Einrichtung in der n8n-Knoten-Konfigurationsoberfläche durch. Du musst keine n8n-Konfigurationsdatei bearbeiten.Einrichtung
1
AI Agent und OpenAI Chat Model hinzufügen
Öffne einen Workflow und füge einen AI Agent-Knoten hinzu. Füge an seinem Chat Model-Anschluss den Unterknoten OpenAI Chat Model hinzu.Diese Anleitung verwendet OpenAI Chat Model, da es die Modellverbindung für n8n AI Agents, Chains und andere KI-Workflows bereitstellt.
2
OpenAI-Zugangsdaten erstellen
Öffne in OpenAI Chat Model Credential to connect with, wähle Create new credential und dann OpenAI.Wenn deine n8n-Version sowohl OpenAI Account (ChatGPT) als auch API Key anbietet, wähle API Key. Die OpenAI-Account-Authentifizierung gilt für ein offizielles Konto, nicht für eine eigene BetterToken Base URL.
3
BetterToken-Zugangsdaten eingeben
Verwende diese Werte:
Klicke auf Save. n8n testet diese Zugangsdaten gegen
/models unter der konfigurierten Base URL; die vollständige Test-URL lautet daher https://www.bettertoken.ai/v1/models.4
Modell auswählen
Kehre zu OpenAI Chat Model zurück, öffne Model und wähle die in der model plaza angezeigte Model ID eines unterstützten Providers.Wenn die Liste nach dem Speichern der Zugangsdaten nicht aktualisiert wird, öffne den Knoten oder die Zugangsdaten erneut und lade die Modellliste wieder.
5
Chat Completions oder Responses auswählen
Lasse für den ersten Test Use Responses API deaktiviert und führe eine einfache Unterhaltung über den Standardmodus Chat Completions durch.Aktiviere Use Responses API nur, wenn dein Workflow dies benötigt. n8n dokumentiert integrierte Tools wie Web Search, File Search und Code Interpreter für OpenAI Chat Model + AI Agent mit aktiviertem Responses. Diese von OpenAI gehosteten Tools sind nicht automatisch für BetterToken bestätigte Fähigkeiten, teste sie daher mit dem ausgewählten Modell und Endpunkt.
6
Test ausführen
Gib dem AI Agent eine einfache Eingabe:Klicke auf Execute step oder führe den Workflow aus. Die Einrichtung ist abgeschlossen, wenn der Knoten eine Modellantwort zurückgibt.
Verbindung überprüfen
Sende eine kurze Testanweisung. Wenn das Tool ohne Authentifizierungs- oder Model-ID-Fehler antwortet, funktioniert die Verbindung. Starte das Tool nach einer Konfigurationsänderung vollständig neu.Modelle wechseln
Öffne die Modellauswahl oder ändere das FeldModel in der Konfiguration. Verwende die genaue Model ID aus der model plaza und starte dann die aktuelle Sitzung neu.
Häufige Fehler
Zugangsdaten-Test gibt 401 zurück
- Stelle sicher, dass der API Key vollständig ist und keine zusätzlichen Leerzeichen enthält
- Bestätige, dass der Key eine Model ID des unterstützten Providers verwendet
- Prüfe Key-Status und Guthaben im BetterToken Dashboard
Zugangsdaten-Test gibt 404 zurück
- Die Base URL muss
https://www.bettertoken.ai/v1sein - Verwende
https://www.bettertoken.ai/v1/modelsnicht als Base URL - Hänge nicht
/chat/completionsoder/responsesan
Die Modellliste ist leer
- Speichere die Zugangsdaten erneut und öffne dann Model wieder
- Bestätige, dass der API Key auf
https://www.bettertoken.ai/v1/modelszugreifen kann - Kopiere eine aktuelle Model ID aus der model plaza; verwende keine eingestellte oder falsch geschriebene ID
Einfacher Chat funktioniert, aber Agent-Tool-Aufrufe schlagen fehl
Deaktiviere Use Responses API und alle integrierten Tools und prüfe dann einfache Chat Completions. Aktiviere Agent-Tools einzeln, um zu erkennen, ob das Problem bei Modellfähigkeit, Tool-Argumenten oder Workflow-Konfiguration liegt.Das Request-Timeout tritt auf
Erhöhe Timeout unter OpenAI Chat Model > Options und behalte einen begrenzten Wert für Max Retries bei. Wiederhole400, 401 oder Konfigurationsfehler nicht fortlaufend.
Advanced setup
Unterstützte Provider
Die Statusangaben gelten für die auf dieser Seite beschriebene BetterToken-Konfiguration.
Bedeutung der Einrichtungsmethoden
Bedeutung der Einrichtungsmethoden
- Manuelle Konfiguration: Gib API Key, Base URL und Model ein.
- Nicht unterstützt: Derzeit gibt es keine verifizierte Methode für die direkte Verbindung.
Verwandte Anleitungen
- n8n-OpenAI-Zugangsdaten
- n8n OpenAI Chat Model
- OpenAI-kompatible API und Anthropic-kompatible API: Unterschiede
- Modell auswählen
Technische Details
Protokoll, Endpunkt und interne Provider-Felder
Protokoll, Endpunkt und interne Provider-Felder
Diese Einrichtung verwendet
https://www.bettertoken.ai/v1. Das Tool hängt den OpenAI-kompatiblen Endpunktpfad an. Füge /chat/completions oder /responses nicht hinzu, sofern ein bestimmtes Feld dies nicht ausdrücklich verlangt.
