Baiyun Superintelligenz BAIYUN.SI
API-Integrationstutorial

Baiyun API Tutorial: Schnell loslegen

Frei zu lesen

Vom Einloggen, Einlegen und Erstellen von Schlüsseln bis zur ersten Klartext-API-Anfrage. Beinhaltet vollständige Inspektionsschritte, praktische Überprüfung und Fehlerbehandlung.

Fangen wir an

Diese Seite hilft Ihnen, die Seite über Website-Chat oder API-Aufrufe zu nutzen. Der aktuelle Leistungsumfang ist:Vollständige, überprüfbare Klartextanfragen。

Erleben Sie es auf der Website

  1. Registrieren Sie sich oder loggen Sie sich mit diesem Seitenkonto an.
  2. OffenGeldbörseNach Bestätigung des Doken (WordKnife, DK) Betrags und des tatsächlichen RMB-Zahlungsbetrags wird über Alipay oder WeChat aufgeladen; Der aktuelle Einheitspreis beträgt 0,30 RMB/DK.
  3. OffenChat-ErfahrungWählen Sie das offene Modell aus und reichen Sie zuerst eine kurze, normale Textfrage ein.
  4. ExistierenBedienkonsoleSehen Sie sich Nutzungs- und Verbrauchsaufzeichnungen an.

Derzeit basiert der Konsum auf dem Kontostand; ein Mitgliedsabonnement ist nicht erforderlich. Bitte lest weiter, bevor ihr euch auftankt oder das Spiel beendetNutzungsregeln。

Erstellen Sie einen Aufrufschlüssel für die Anwendung

ExistierenSchlüsselverwaltungAPI-Schlüssel für Modellaufrufe erstellen; Setze Balance und modelliere Limits entsprechend den tatsächlichen Bedürfnissen und speichere sie nach dem Speichern richtig.

Die App verwendet dieModellaufrufschlüssel, kein Web-Login-Passwort. Schreiben Sie keine Schlüssel in öffentlichen Code, Screenshots, Chat-Inhalte oder browserzugänglichen Frontend-Code. Durchgesickerte Schlüssel sollten widerrufen und in der Schlüsselverwaltung neu erstellt werden.

Konfigurieren Sie den Client

Konfigurationselemente Aktuell gefüllter Inhalt
API Base URL https://api.baiyun.si/v1
API Key Der Anrufschlüssel, der von der Schlüsselverwaltung der Seite erstellt wird
Modell Zum Beispiel gpt-6-luna; Für die genaue Liste siehe Model Square
Schnittstelle Textmodus für Chat-Komplettierungen oder -antworten

Verschiedene Kunden definieren Adressen unterschiedlich: Füllen sie aus Base URL Er wird zu diesem Zeitpunkt üblicherweise beibehalten /v1; Wenn Sie die vollständige Chat-Adresse ausfüllen müssen, geben Sie sie bitte aus https://api.baiyun.si/v1/chat/completions。 Steck es nicht weg. /v1 Wiederhole das Schneiden zweimal. Nicht alle Clients, Plugins und Funktionen sind standardmäßig kompatibel.

Die erste API-Anfrage

Stellen Sie Umweltvariablen am lokalen Terminal ein, um beim Eingabe des Schlüssels das gemeinsame Terminal oder den Aufnahmebildschirm nicht zu betreten:

bash
read -r -s -p '请输入本站 API 密钥:' BAIYUN_API_KEY
printf '\n'
export BAIYUN_API_KEY

curl --fail-with-body https://api.baiyun.si/v1/chat/completions \
  -H "Authorization: Bearer $BAIYUN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-6-luna",
    "messages": [{"role": "user", "content": "你好,请用一句话介绍你能帮我做什么。"}],
    "stream": false
  }'

Eine erfolgreiche Anfrage liefert den generierten Text und Nutzungsinformationen zurück und zieht den DK-Saldo vom angegebenen Referenzeinheitspreis ab. 1 DK bezeichnet die Charge von Tokens, die laut ausgewählten kommerziellen API-Referenzkursen mit 1 USD bepreist sind, nicht auf feste Tokenmengen oder in US-Dollar konvertierbare Bargeld. Die oben genannten normalen Anfragen erzeugen ebenfalls einen kleinen Verbrauch.

Die aktuellen 0,30 RMB/DK sind der Ladepreis auf dieser Seite, nicht der genaue Abonnementpreis, der durch tatsächliche Tests nachgewiesen wurde; Referenzwert und Abonnementkosten für denselben Token-Batch werden in der RMB- oder JPY-Umrechnung angezeigtDreistufige Abrechnungsanweisungen。

Wenn du kontinuierlich Ausgabe empfangen möchtest, schau es dir anBeispiel für Chat-Streaming; Wenn Sie Antworten verwenden, kann die App sie anzeigenBeispiele für Antworten。

Überprüfen Sie die aufrufbaren Modelle

Die Schnittstelle für die Modellliste erfordert außerdem die Schlüsselauthentifizierung:

bash
curl --fail-with-body https://api.baiyun.si/v1/models \
  -H "Authorization: Bearer $BAIYUN_API_KEY"

Das Modell, das tatsächlich den aktuellen Schlüssel zurückgibt, hat Vorrang. Wenn das Modell nicht existiert oder nicht verfügbar ist, überprüfen Sie bitte den Modellnamen, die Schlüsselgrenzen und das Balancing und versuchen Sie nicht wiederholt nicht unterstützte Anfragen.

Checkliste vor praktischer Anwendung

  1. Bereiten Sie Ihr eigenes Konto und Ihre Zugangsschlüssel vor und verwenden Sie keine gemeinsamen Zugangsdaten anderer.
  2. Zeichnet Client-Versionen, Systeme und Modelle auf, die zur einfachen Reproduktion während der Fehlersuche verwendet werden.
  3. Speichere die Originalkonfiguration oder den Screenshot, verstecke Schlüssel, Verifizierungscodes und private Inhalte.
  4. Bestätigen Sie, dass das Testen eine kleine Menge DK verbrauchen kann, beginnend mit einem einzelnen Satz und einer einzigen Anfrage.
  5. Ü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.

Wenn du es gelernt hast, probiere es aus.

Nutze die 100 Fragen von SIN1, um deine Foundation zu überprüfen.

Mach den Test

Kontaktieren Sie die Baiyun SI Community

Kontaktieren Sie per E-Mail.

Für Anfragen, Bedarfsaustausch oder Kooperationsgespräche senden Sie bitte eine E-Mail.