Dify in Russland: OpenAI-kompatible API und erster Workflow

Dify kann über seinen offiziellen Model Provider OpenAI-API-compatible mit einer externen API verbunden werden. Sie benötigen Ihren eigenen API Key, eine kompatible Base URL und eine aktuelle Model ID. Für einen verlässlichen ersten Test bauen Sie einen Workflow mit Texteingabe, einem LLM-Knoten und Textausgabe, führen ihn genau einmal aus und gleichen das Ergebnis mit dem Eintrag beim Provider ab.

Benötigen Sie für diesen Workflow Ihren eigenen API Key? BetterToken-Konto erstellen

Für einen ersten Dify-Test mit einem einzigen Workflow ohne externe Aktionen verwenden Sie einen separaten BetterToken-Test-Key und öffnen die aktuelle Dify-Anleitung. Sie behandelt den Modell-API-Zugang. Die Installation von Dify, Marketplace, Drittanbieter-Plugins, Agents und Tools sind davon getrennte Ebenen.

Was Sie vorbereiten sollten

• eine funktionierende Dify-Cloud-Instanz oder selbst gehostete Dify-Installation;
• Zugriff auf Integrations/Marketplace und Model Providers;
• Ihren eigenen BetterToken API Key;
• eine aktuelle Model ID aus der BetterToken-Model-Plaza;
• einen neuen Test-Workflow ohne Tools und ohne externe Aktionen.

Aus Russland lässt sich der BetterToken API Endpoint ohne VPN erreichen. Das ist keine Zusage für die Erreichbarkeit von Dify Cloud, Marketplace, GitHub, einer Docker Registry oder Drittanbieter-Plugins.

1. Den offiziellen Provider installieren

Öffnen Sie in Dify Integrations oder Marketplace und anschließend Model Providers. Suchen Sie nach dem offiziellen Provider OpenAI-API-compatible und installieren Sie ihn, falls er noch nicht verfügbar ist.

Prüfen Sie Autor und Eintrag im offiziellen Dify Marketplace. Verwenden Sie kein zufälliges Plugin mit einem ähnlichen Namen: Die Felder und die Verarbeitung von Zugangsdaten können abweichen.

2. Ein BetterToken-Modell hinzufügen

Öffnen Sie die Provider-Einstellungen und fügen Sie ein neues LLM-Modell hinzu. Tragen Sie ein:

1. Model Type: LLM.
2. Model Name / ID: die exakte aktuelle Model ID.
3. API Key: Ihren eigenen BetterToken API Key.
4. API Base URL: https://www.bettertoken.ai/v1.
5. Completion mode: Chat, sofern der gewählte Provider und das Modell dies verlangen.

Hängen Sie nicht selbst /chat/completions an die Base URL an: Der Provider setzt den vollständigen Pfad zusammen. Kopieren Sie keine echten Zugangsdaten in einen App-Export, Screenshot oder Issue.

Wenn die Oberfläche nach Kontextgröße, max tokens, Vision- oder Streaming-Parametern fragt, verwenden Sie ausschließlich Werte aus der aktuellen Modelldokumentation. Für den ersten Test sind keine Zusatzfunktionen nötig.

3. Zugangsdaten speichern und prüfen

Dify validiert die Zugangsdaten beim Speichern. Das zeigt lediglich, dass der Provider seine Authentifizierungsprüfung abschließen konnte; der gesamte Workflow ist damit noch nicht bestätigt.

Bewahren Sie nach einem Fehler nur sichere Diagnosedaten auf:

• Name und Version des Providers;
• Model ID;
• Base URL ohne Key;
• kurzer Fehlertyp und HTTP-Status;
• Zeitpunkt des Versuchs.

Speichern Sie weder den API Key noch eine vollständige sensible Antwort.

4. Einen minimalen Workflow anlegen

Erstellen Sie eine neue Anwendung vom Typ Workflow. Fügen Sie nur drei Elemente hinzu:

1. Start mit einer Textvariablen namens question.
2. LLM mit dem hinzugefügten BetterToken-Modell.
3. End mit dem Antworttext des LLM.

Verwenden Sie für das LLM dieses einfache Prompt-Template:

Antworte in einer Zeile. Eingabe: {{question}}

Verbinden Sie Start → LLM → End. Fügen Sie keine HTTP-Tools, Datenbank, Wissensabruf, Agent-Schleife oder Veröffentlichung hinzu. Sie erschweren die Eingrenzung des ersten Fehlers.

5. Einen Test ausführen

Senden Sie diese Eingabe:

Gib DIFY_OK und die Zahl 4 als Summe von 2 + 2 zurück.

Die Konfiguration ist bestätigt, wenn:

• Dify den erwarteten Text ausgibt;
• der LLM-Knoten ohne Credential-, Model- oder Endpoint-Fehler endet;
• das BetterToken Dashboard einen Eintrag mit dem erwarteten Modell und Status zeigt;
• das Dashboard Input, Output, gegebenenfalls Cache Tokens und die zugehörige Belastung ausweist.

Der Abgleich von Dify-Lauf und Dashboard schließt aus, dass der Workflow unbemerkt einen anderen Provider oder ein anderes Modell genutzt hat.

Fehler unterscheiden

Provider oder Plugin lässt sich nicht installieren

Das gehört zur Ebene Dify Marketplace/Plugin-Daemon. Prüfen Sie in einer selbst gehosteten Umgebung Dify-Version, Netzwerkzugriff des Plugin-Daemons, HTTPS und Zertifikatskette. Ein anderer BetterToken API Key behebt diesen Fehler nicht.

ToolProviderCredentialValidationError oder 401

Geben Sie den Key erneut ein, prüfen Sie auf Leerzeichen und kontrollieren Sie den gewählten Provider. Stellen Sie sicher, dass die Zugangsdaten zum Modell und nicht zu einem unabhängigen Tool-Plugin gehören.

404

Prüfen Sie die Base URL:

https://www.bettertoken.ai/v1

Entfernen Sie ein manuell hinzugefügtes /chat/completions, wenn das Feld eine API Base URL erwartet.

model not found

Kopieren Sie die aktuelle ID aus der Model Plaza. Prüfen Sie, ob diese ID für den neu angelegten Key und den gewählten OpenAI-kompatiblen Provider verfügbar ist.

Die Zugangsdaten werden gespeichert, aber der Workflow schlägt fehl

Testen Sie zunächst nur den LLM-Knoten. Entfernen Sie Tools, Streaming und strukturiertes Output und wiederholen Sie den kurzen Text-in/Text-out-Lauf. Wenn er funktioniert, fügen Sie weitere Knoten einzeln wieder hinzu.

Geltungsbereich dieser Einrichtung

Der erste Workflow bestätigt eine Modellanfrage über den offiziellen OpenAI-API-compatible Provider. Er beweist keine Kompatibilität mit jedem Dify-Agent, Community-Plugin, Tool oder externen Dienst. Legen Sie für jede Aktion mit Nebenwirkung einen separaten Test an und verlangen Sie eine ausdrückliche Nutzerbestätigung.

Aktuelle Felder und Einschränkungen finden Sie in den BetterToken Docs für Dify. Prüfen Sie dynamische Model IDs und Preise am Tag der Konfiguration.