Baiyun API Tutorial: Cherry Studio Integration Guide
Konfigurationsschritte, relevante Voraussetzungen und häufige Kompatibilitätsprobleme. Beinhaltet vollständige Inspektionsschritte, praktische Überprüfung und Fehlerbehandlung.
Cherry Studio Eingangsleitfaden
Zubereitung vor der Anwendung
ExistierenSchlüsselverwaltungErstellen Sie für dieses Tool separat einen eigenen Call-Key, um zu bestätigen, dass das Konto vollständig ist und der DK-Saldo ausreichend ist. Die Client-Version beeinflusst den Eintragsnamen; diese Seite erklärt die Konfigurationselemente; Bitte beachten Sie die aktuelle Version der eigentlichen Benutzeroberfläche.
Konfigurationsschritte
Open Model Services in Settings und hinzufügen von OpenAI-kompatiblen Anbietern; Füllen Sie die Basis-URL und Ihren eigenen Anrufschlüssel aus. Füge manuell den genauen Modellnamen im Model Plaza hinzu, speichere ihn und wähle ihn in einer neuen Chat-Sitzung aus.
| Konfigurationselemente | Füllen Sie den Inhalt aus |
|---|---|
| Base URL | https://api.baiyun.si/v1 |
| API Key | Dieser kundenspezifische Rufschlüssel |
| Modellbeispiel | gpt-6-luna |
| Gewöhnliches Chatprotokoll | OpenAI Compatible Chat Completions |
| Codex-Lieferantenvereinbarung | Responses |
Minimale Validierung
Schalten Sie zuerst Online-Suche, Bilder, Anhänge, Wissensdatenbanken und automatische Ausführungswerkzeuge aus und senden Sie dann einen einfachen Satz. Überprüfen Sie, ob der Kunde tatsächlich unseren Lieferanten ausgewählt hat, und dannNutzungsprotokollSehen Sie sich dieses Modell an und konsumieren Sie. Der Client-Verbindungsbutton kann nur die Modellliste prüfen und kann einen echten Chat nicht ersetzen.
Häufig gestellte Fragen
Wenn eine Adresse einen vollständigen Endpunkt benötigt, sollte die Chat-Adresse sein: https://api.baiyun.si/v1/chat/completions； Wenn Sie eine Basis-URL anfordern, verwenden Sie die Adresse in der Tabelle. Erscheinen Sie /v1/v1 Oder wiederhole /chat/completions Zu diesem Zeitpunkt wurde die Adresse zuerst geändert. 401 Schlüssel und effektive Lieferanten überprüfen; 429 Paralleltests stoppen und warten; 404 Protokolle und Modelle überprüfen; nicht unterstützte Protokolle nicht als ein anderes Modell tarnen.
Fähigkeiten und Daten
Diese Seite bietet Konfigurationshinweise und führt keine vollständige Echtzeit-Tests für jede Client-Version durch. Benutzerdefinierte Modelle garantieren keinen Zugriff auf die offizielle Modellabschluss, Tools oder Abonnementfunktionen des Kunden. Drittanbieter-Clients können Sitzungen hochladen oder synchronisierte Daten konfigurieren; überprüfen Sie ihre Datenschutzeinstellungen vor der Nutzung; Exportieren Sie keine Konfigurationen, die Schlüssel enthalten.
Offizielles Kundenprofil · Beschreibung der Standortvereinbarung · Fehlerbehebung
Checkliste vor praktischer Anwendung
- Bereiten Sie Ihr eigenes Konto und Ihre Zugangsschlüssel vor und verwenden Sie keine gemeinsamen Zugangsdaten anderer.
- Zeichnet Client-Versionen, Systeme und Modelle auf, die zur einfachen Reproduktion während der Fehlersuche verwendet werden.
- Speichere die Originalkonfiguration oder den Screenshot, verstecke Schlüssel, Verifizierungscodes und private Inhalte.
- Bestätigen Sie, dass das Testen eine kleine Menge DK verbrauchen kann, beginnend mit einem einzelnen Satz und einer einzigen Anfrage.
- Überprüfen Sie die aktuelle Modell-Plaza und die Status-Seite, bevor Sie entscheiden, ob Sie weitere Funktionen aktivieren möchten.
Detaillierte Untersuchung: Das Umfang des Problems eingrenzen, um die Reihenfolge zu erreichen
Zuerst bestätigen Sie, dass das Konto vollständig ist, der Schlüssel gültig ist und das DK-Guthaben ausreichend ist, dann überprüfen Sie das Protokoll, die Adresse und das Modell. Stellen Sie eine minimale Textanfrage mit demselben Schlüssel; Erst wenn es gelingt, stellt es Anhänge, Werkzeuge wieder her oder versucht automatisch jeden Gegenstand erneut. Nachdem Sie die Client-Konfiguration gespeichert haben, öffnen Sie die Sitzung erneut, um die Nutzung des vorherigen Anbieters in der alten Sitzung zu vermeiden.
Wie man bestätigt, dass dieser Abschnitt gelernt wurde
Kreuze nicht einfach die Eingabe "Konfiguration erfolgreich gespeichert" an. Du solltest in der Lage sein, die aktuelle Basis-URL, die Schlüsselnutzung, das gewählte Modell und das Anfrageprotokoll klar anzugeben und deine Betriebsergebnisse auf der entsprechenden Konsole überprüfen zu können. Das clientseitige Tutorial verwendet eine einzelne tatsächliche Klartextantwort und entsprechende Logs als Anfangsabschlussstandard; Konto-Tutorials basieren auf umfassenden Sicherheitsinformationen; Das Abrechnungstutorial verwendet die Korrespondenz zwischen Principal, Channel Fees und DK als Standard.
Tritt ein Fehler auf, notieren Sie die Ereigniszeit, den HTTP-Status, den Inhalt des anonymisierten Fehlers und das tatsächlich erwartete Ergebnis. Mach keinen Screenshot des gesamten Seitenschlüssels und gib weder das Passwort noch den Verifizierungscode an andere weiter. Bei 401 sollte die Authentifizierung zuerst gelöst werden; bei 400 zuerst die Parameter; bei 429 sollten intensive Wiederholungen gestoppt werden; bei 404 sollten Anfragepfade und Upstream-Verifizierung überprüft werden; Nachladen kann nicht alle Fehler beheben.
Eine kleine Aufgabe, die sich zum Üben eignet
Erledigen Sie die Mindestanforderungen in diesem Abschnitt in Ihrer eigenen Testumgebung und notieren Sie in Text: "Wie Sie es ursprünglich eingestellt haben, welches Element Sie modifiziert haben und welche Ergebnisse Sie gesehen haben." Behandeln Sie Produktionsdaten, reale Zahlungen oder nicht wiederherstellbare Befehle nicht als Übungen. Wenn du auf Funktionen stoßen, die über das hinausgehen, was dieser Abschnitt bietet, schau dir zuerst das entsprechende Protokoll-Tutorial an, bevor du darüber nachdenkst, Funktionen hinzuzufügen; Wenn man immer nur eine Konfiguration gleichzeitig ändert, kann man leicht beurteilen, welcher Schritt zu Fehlern führt.
Der nächste Schritt ist der Rand der Version
Rückkehr zur vollständigen Lernkarte · Optimierte API-Standortkonfiguration · Echtzeitstatus dieser Seite。
Das Tutorial wurde am 9. Oktober 2026 zusammengestellt. Die spezifische Benutzeroberfläche und Fähigkeiten können je nach Client und Upstream-Version variieren; Die Konfigurationsrichtlinien bedeuten nicht, dass alle Client-Versionen den Test bestanden haben. Für Guthabenzahlungen, QQ / Alipay-Login und offene Kanäle siehe bitte die eigentliche Seitenseite; Kompressionsschnittstellen: Früher waren upstream-404- und RAW-Bildkanäle nicht verfügbar, daher sollten Sie nicht davon ausgehen, dass Konfigurationsdateien automatisch entfernt werden können.