KI-Anwendungsplattformen einrichten

Dify mit BetterToken: API Key, Base URL und Modelle

Verbinde Dify mit BetterToken über Base URL, API Key und ein verfügbares Modell, prüfe dann die Verbindung und behebe typische Einrichtungsfehler.

Um Dify mit BetterToken zu verbinden, bereite einen API Key vor, trage die unten angezeigte Base URL ein und wähle eine aktuelle Model ID aus der model plaza.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Eine aktuelle Model ID aus der model plaza

Voraussetzungen

Die aktuelle Version des Tools ist installiert
Ein BetterToken API Key: Registriere dich und erhalte einen
Eine Model ID aus der model plaza

Registrieren und BetterToken API Key erhalten

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Zusätzliche Anforderungen

Dify Cloud oder eine selbst gehostete Dify-Instanz mit aktivierten Plugins
Berechtigung zur Installation von Modell-Plugins und Verwaltung von Workspace-Modellen

Installation

OpenAI-kompatibles Modell-Plugin installieren

Model Providers öffnen

Gehe im Dify-Workspace zu Integrations > Model Providers.

Offizielles Plugin installieren

Klicke auf Install model providers, suche nach OpenAI-API-compatible und installiere es.

Dify verwaltet Modell-Provider als Plugins auf Workspace-Ebene. Nach der Installation können Apps mit den erforderlichen Workspace-Berechtigungen Modelle dieses Providers auswählen.

Eigenes Modell hinzufügen

Klicke auf der Karte OpenAI-API-compatible auf Add Model. Wenn die Karte zuerst Setup oder Configure zeigt, öffne sie und wähle dann die Option zum Hinzufügen eines Modells.

Manuelle Einrichtung

Führe diese Einrichtung in der Dify-Benutzeroberfläche für Modell-Provider durch. Du musst keine Konfigurationsdatei bearbeiten.

Feld	Wert
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Eine aktuelle Model ID aus der model plaza

Modellkonfiguration eingeben

Verwende diese Werte für das erste Modell:

Dify-Feld	Empfohlener Wert
Model Type	`LLM`
Model Name	eine Model ID aus der model plaza
Model display name	derselbe Wert wie Model Name ist ausreichend
API Key	dein BetterToken API Key
API Base URL	`https://bettertoken.ai/v1`
model name for API endpoint	dieselbe Model ID wie Model Name
Completion mode	`Chat`
Model context size	an das ausgewählte Modell anpassen; im Zweifel den Plugin-Standard beibehalten
Upper bound for max tokens	das ausgewählte Modell nicht überschreiten; für den ersten Test den Plugin-Standard beibehalten
Compatibility mode	`OpenAI compatible` / strict
Token parameter name	`Auto`
Function Call Type	`Not Support` für den ersten Test

Verwende für die übrigen optionalen Funktionen konservative Werte:

Thinking Mode Support: aktiviere dies erst nach Bestätigung der Modellunterstützung
Stream function calling: wähle für den ersten Test Not Support
Vision Support: aktiviere dies nur, wenn Modell und Endpunkt Bildeingaben akzeptieren
Structured Output: lasse es deaktiviert, bis normaler Chat funktioniert

Lass Include Usage in Stream (stream_include_usage) auf dem Standardwert Enabled. Damit wird stream_options: {include_usage: true} ergänzt, um Tokenzahlen im letzten Stream-Chunk zurückzugeben. Deaktiviere die Option nur, wenn der Endpunkt dieses Feld ablehnt. Stream mode auth (stream_mode_auth) steht standardmäßig auf Not Use; mit Use erfolgt die Prüfung der Zugangsdaten über eine Streaming-Anfrage, ohne die normalen Generierungseinstellungen zu ändern. Siehe die offiziellen Provider-Felder.

Klicke auf Save. Dify prüft API Key, Base URL und Model ID.

Modell in einer App verwenden

Dify-App erstellen oder öffnen

Öffne einen Chatbot, Agent, Chatflow oder Workflow.

Modell auswählen

Wähle in der Modellauswahl der App oder in einem LLM-Knoten das Modell, das du unter OpenAI-API-compatible hinzugefügt hast.

Zuerst einfachen Chat testen

Führe die erste Anfrage mit einer kurzen Texteingabe ohne Tools oder Bilder aus:

Reply with exactly: Connection successful

Agent-Funktionen anschließend aktivieren

Bearbeite nach erfolgreichem einfachem Chat die Modellkonfiguration, wenn du Tool-Aufrufe benötigst. Setze Function Call Type auf den vom Modell unterstützten Modus. OpenAI-kompatibles Tool Calling verwendet normalerweise Tool Call, aber du musst die Unterstützung für das ausgewählte Modell und den Endpunkt prüfen.

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 Feld Model in der Konfiguration. Verwende die genaue Model ID aus der model plaza und starte dann die aktuelle Sitzung neu.

Dify speichert die eigene Konfiguration pro Model ID. Um ein weiteres Modell aus der model plaza hinzuzufügen, klicke unter demselben Provider erneut auf Add Model. Verwende die neue ID sowohl für Model Name als auch für model name for API endpoint. Du kannst Base URL und API Key wiederverwenden.

Häufige Fehler

Speichern gibt 401 zurück

Prüfe, ob der API Key vollständig ist
Kopieren Sie die genaue Model ID aus der model plaza.
Prüfe Key-Status und Guthaben im BetterToken Dashboard

Speichern gibt 404 zurück

Die API Base URL muss https://bettertoken.ai/v1 sein
Hänge nicht /chat/completions an
Stelle sicher, dass model name for API endpoint genau der ID aus der model plaza entspricht

Dify meldet Modell nicht gefunden

Model Name kann beeinflussen, wie Dify das Modell anzeigt und auswählt. Das tatsächlich angeforderte Modell wird durch model name for API endpoint gesteuert. Verwende in beiden Feldern dieselbe Model ID aus der model plaza.

Einfacher Chat funktioniert, aber Agent-Tools schlagen fehl

Setze Function Call Type zurück auf Not Support und überprüfe einen grundlegenden LLM-Knoten. Ändere es nur zu Tool Call, wenn das ausgewählte Modell Tool Calling unterstützt, und teste dann die Tool-Argumente erneut.

Knowledge kann dieses Modell nicht als Embedding Model verwenden

Das ist zu erwarten. Ein Chat-LLM kann kein Embedding-Modell ersetzen. Diese Anleitung bestätigt keine BetterToken-Embedding- oder Rerank-Endpunkte für Dify; konfiguriere für Knowledge separat einen unterstützten Embedding Provider.

Advanced setup

Technische Details

Protokoll, Endpunkt und interne Provider-Felder

Diese Einrichtung verwendet https://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.