Dify-Integration

Konfiguration von 1折AI mit dem offiziellen OpenAI-API-kompatiblen Dify-Plugin, einschließlich Modelleinrichtung, Gesprächstests und Fehlerbehebung beim ersten Aufruf.

Dify-Nutzer können den OpenAI-kompatiblen Endpunkt von 1折AI über das offizielle Modell-Plugin OpenAI-API-compatible konfigurieren. Überprüfen Sie zuerst ein Textmodell und verwenden Sie es dann in Workflows; es ist nicht notwendig, unverifizierte Drittanbieter-Plugins zu installieren.

Voraussetzungen

Ein Dify-Arbeitsbereich, in dem Modell-Plugins installiert werden können.
Ihr eigener 1折AI-API-Schlüssel sowie die Modell-IDs, die dieser Schlüssel abrufen darf. Überprüfen Sie die Konsole.
Ausreichend verfügbares Guthaben auf Ihrem Konto. Die Validierungsanfrage beim Speichern eines Modells und Anwendungstests können normale API-Gebühren verursachen.

Senden Sie Ihren vollständigen Schlüssel nicht an den Kundensupport, schreiben Sie ihn nicht in Workflow-Beschreibungen, Screenshots oder öffentliche Repositories. Speichern Sie ihn nur im API-Key-Feld von Dify; wenn Sie einen Drittanbieter-gehosteten Dify verwenden, verwaltet diese Instanz Ihren Schlüssel und leitet Anfragen weiter.

Hinzufügen eines Modells

Suchen Sie im Dify-Plugin-Marktplatz nach OpenAI-API-compatible und bestätigen Sie, dass der Herausgeber langgenius ist.
Öffnen Sie die Modellanbieter in den Arbeitsbereichseinstellungen, finden Sie dieses Plugin und fügen Sie ein LLM-Modell hinzu.
Füllen Sie die folgenden Felder aus und speichern Sie. Die Beschriftungen der Oberfläche können je nach Dify-Version variieren.

Feld	So füllen Sie es aus
Model Name	Kopieren Sie die vollständige Modell-ID aus der 1折AI-Konsole; ersetzen Sie sie nicht durch den Anzeigenamen
API Key	Ihr eigener 1折AI-Schlüssel
API Base URL	`https://1zheai.com/v1`
Completion mode	`Chat`
Modellname im API-Endpunkt	Normalerweise leer lassen; wenn gesetzt, muss er mit der tatsächlichen Modell-ID übereinstimmen
Modellkontextgröße	Gemäß der tatsächlichen Fähigkeit des ausgewählten Modells ausfüllen; kopieren Sie nicht die Kontextlänge eines anderen Modells

Hier benötigen Sie /v1. Geben Sie nicht die vollständige /v1/chat/completions ein und duplizieren Sie sie nicht als /v1/v1. Wenden Sie keine Anweisungen von anderen Clients an, die nur die Basisadresse erfordern.

Start mit dem ersten Gespräch

Erstellen Sie eine leere Chat-App, wählen Sie das gerade gespeicherte Modell und geben Sie „Stelle in einem Satz auf Chinesisch vor, was du kannst.“ ein. Sobald eine vollständige Textantwort bestätigt ist, überprüfen Sie als Nächstes die Streaming-Ausgabe.

Überprüfen Sie die entsprechende Anfragezeit, das Modell und das Ergebnis in den Aufrufprotokollen der 1折AI-Konsole. Verlassen Sie sich nicht allein auf „Erfolgreich gespeichert“ von Dify als Beweis, dass die App verbunden ist. Erst nach dem ersten Erfolg sollten Sie Tool-Aufrufe, Vision-Eingaben oder Wissensbasis-Abfragen konfigurieren; diese Fähigkeiten hängen vom jeweiligen Modell und der Schnittstelle ab, und ein erfolgreiches Textgespräch bedeutet nicht, dass alles verfügbar ist.

Importieren des Beispiel-Chatflows

Laden Sie die Chatflow-Vorlage ohne Schlüssel herunter und wählen Sie dann in Dify Studio Create → Import DSL file, um sie hochzuladen. Die Vorlage ist User Input → LLM → Answer, DSL-Version 0.7.0, und verwendet das offizielle kompatible Plugin 0.0.68.

Fügen Sie zuerst Ihre eigenen Anmeldedaten gemäß den obigen Schritten hinzu. Nach dem Import öffnen Sie den LLM-Knoten und bestätigen, dass Ihr eigener Anbieter und Modell ausgewählt sind, nicht das Testmodell von Dify. Die Beispiel-Modell-ID ist claude-haiku-4-5-20251001; wenn sie für Ihr Konto nicht verfügbar ist, wechseln Sie zu einem Modell, auf das Sie Zugriff haben, und überprüfen Sie die Fähigkeitseinstellungen. Die Vorlage enthält keinen API-Schlüssel und bietet keine kostenlosen Aufrufguthaben.

Fehlerbehebung

Symptom	Was zuerst zu überprüfen ist
503 / Keine verfügbaren Konten	Der aktuelle Upstream ist möglicherweise rate-limitiert oder hat keine Kapazität mehr. Überprüfen Sie zuerst den Dienststatus und die Aufrufprotokolle, versuchen Sie es später mit Backoff erneut oder kontaktieren Sie den Support; wiederholen Sie keine hochfrequenten Wiederholungen und generieren Sie keine Schlüssel wiederholt neu
401 / Ungültiger Schlüssel	Ob zusätzliche Leerzeichen vorhanden sind, ob der Schlüssel widerrufen wurde und ob versehentlich ein Schlüssel von einer anderen Plattform verwendet wurde
404	Ob die Base URL exakt `https://1zheai.com/v1` ist; ob die Modell-ID existiert
Modell nicht erlaubt oder unzureichendes Guthaben	Die Modellbeschränkungen des aktuellen Schlüssels, das verfügbare Guthaben des Kontos und das ausgewählte Modell
Erfolgreich gespeichert, aber die App kann nicht aufrufen	Ob die App den richtigen Anbieter und das richtige Modell ausgewählt hat; ob der Arbeitsbereichsserver die API erreichen kann
Normale Antworten funktionieren, Streaming schlägt fehl	Überprüfen Sie die SSE-Unterstützung des Proxys, die Plugin-Version und die Streaming-Usage-Einstellung; bewahren Sie einen geschwärzten Fehler zur Fehlerbehebung auf
Tool-Aufrufe oder Vision schlagen fehl	Bestätigen Sie zuerst, ob das ausgewählte Modell diese Fähigkeit tatsächlich unterstützt; erzwingen Sie sie nicht nur durch Umschalten von Plugin-Schaltern

Anfragen von selbst-gehostetem Dify werden von dessen Server gesendet; die Tatsache, dass Ihr Browser die offizielle Website öffnen kann, bedeutet nicht, dass der Dify-Server die API erreichen kann.

Hilfe bei der Integration erhalten

Geben Sie die Dify-Version, die Plugin-Version, die Modell-ID, den Fehlerzeitstempel, die Anfrage-ID und geschwärzte Fehlerdetails über den Online-Kundenservice der offiziellen Website an. Senden Sie nicht den vollständigen Schlüssel, Kundendaten oder private Prompts aus Ihren Workflows.

Überprüfungsumfang

Am 2026-10-19 wurden mit dem offiziellen Plugin 0.0.68 Haiku-Textgespräche und Streaming-Aufrufe in Dify Cloud abgeschlossen und mit den Gateway-Protokollen abgeglichen. Der exportierte DSL ohne Schlüssel wurde in denselben Arbeitsbereich als neue App importiert. Nach dem Import traf ein erneuter Test auf einen durch Upstream-Rate-Limiting verursachten 503, daher wird diese Runde nicht als bestandener Post-Import-Lauf erfasst.

Dies ist ein interner Test mit einem definierten Zeitfenster, keine kontinuierliche Verfügbarkeitsgarantie. Neue Arbeitsbereiche, ältere Dify-Versionen, Tool-Aufrufe, Vision und Wissensbasis-Abfragen wurden nicht überprüft; führen Sie Ihren ersten Test mit Ihrem eigenen rate-limitierten Schlüssel durch.

Offizielle Plugin-Quelle · Dify-Plugin-Marktplatz

English / Русский

English: Install the official OpenAI-API-compatible plugin by langgenius. Set API Base URL to https://1zheai.com/v1, use your own API key and an exact model ID available to your account, and select Chat mode. Test a simple conversation before adding tools or vision. Text and streaming calls were verified in Dify Cloud on 2026-10-19. DSL import into a new app in the same workspace succeeded; its subsequent run encountered an upstream-capacity 503. Fresh-workspace import and advanced capabilities remain unverified. Never share your key with support.

Русский: Установите официальный плагин OpenAI-API-compatible от langgenius. Укажите API Base URL https://1zheai.com/v1, собственный API-ключ и точный ID модели, доступной вашему аккаунту; выберите режим Chat. Сначала проверьте простой диалог, затем потоковый вывод. Текстовые и потоковые вызовы проверены в Dify Cloud 19 октября 2026 года. Импорт DSL в новое приложение того же рабочего пространства прошёл, но повторный вызов вернул 503 из-за недоступной мощности upstream. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.