Baiyun Superintelligenz BAIYUN.SI
API-Integrationstutorial

Baiyun API-Tutorial: Chat-Textschnittstelle

Frei zu lesen

Beispiel für Chat-Abschlüsse, die mit SSE-Streaming, Klartextanfragen synchronisiert werden. Beinhaltet vollständige Inspektionsschritte, praktische Überprüfung und Fehlerbehandlung.

Chat-Komplettions-Textoberfläche

Schnittstellenadresse:POST https://api.baiyun.si/v1/chat/completions。

Derzeit stehen Chat-ähnliche Klartextkonversationen für Clients zur Verfügung, die explizit das Chat-Protokoll von OpenAI unterstützen. Bitte um die Nutzung des Site-Schlüssels und reiche den für dieses Gespräch erforderlichen Volltext-Kontext ein.

Anforderungsstruktur

json
{
  "model": "gpt-6-luna",
  "messages": [
    {"role": "system", "content": "用简洁的中文回答。"},
    {"role": "user", "content": "请解释什么是 Token。"}
  ],
  "stream": false
}

model Dies ist der Name des Modells, das tatsächlich auf dieser Seite verfügbar ist;messages Textnachrichten in der richtigen Reihenfolge eingereicht;stream Entscheiden Sie, ob Sie synchron zurückkehren oder streamen. Dieser Artikel präsentiert nur die offene grundlegende Textstruktur; komplexe SDK-Parameter und Erweiterungsfunktionen sollten standardmäßig nicht verfügbar sein.

Synchroner Anruf

bash
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":"用一句话解释 Token。"}],"stream":false}'

Generierter Text befindet sich unter choices[].message.content; Informationen zur Dosierung finden Sie hier usage。 Spezifische Inhalte, Anzahl der Tokens und Gebühren hängen von den tatsächlichen Reaktions- und Konsumaufzeichnungen dieser Zeit ab.

Bachrufe

bash
curl --no-buffer --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":"用三句话介绍 Token。"}],
    "stream":true,
    "stream_options":{"include_usage":true}
  }'

Stream returniert mit SSE: read data: JSON, verkette sie in der richtigen Reihenfolge choices[].delta.content。data: [DONE] Zeigt das Ende des Bachs an; Aktiviert include_usage Die Nutzungsmeldung am Ende muss danach beibehalten werden. Behandle nicht jeden SSE-Shard als eigenständige HTTP-Antwort.

Dialogkontext und Parametergrenzen

Der aktuelle Kanal verwendet das Standard-Sampling des Modells.temperature、top_p、frequency_penalty Und presence_penalty Verstellbare Bedienelemente sind derzeit nicht vorhanden; Gängige Standardwerte auf der Clientseite werden durch Kompatibilitätsverarbeitung entfernt und ändern die Sampling-Einstellungen des Modells nicht.

Mehrere Dialogrunden sollten vorhanden sein messages Reichen Sie die erforderliche vollständige Texthistorie ein. Derzeit sind externe Tools, Netzwerke, Bilder und Dateifunktionen ausgesetzt, und es gibt keine Möglichkeit, Texteinreichungen über ungeprüfte externe Historie zu umgehen.

Einige Modelle oder Clients unterstützen Ausgabeparameter unterschiedlich. Auch wenn du darum bittest, es auszufüllen max_tokens、max_completion_tokens Oder Werte wie 8192 uswEs kann nicht als eine feste Ausgabelänge- oder Kostengrenze betrachtet werden, die von dieser Seite garantiert wird。 Beginnen Sie mit einer kurzen Anfrage, überprüfen Sie Ihre Ausgabenunterlagen und legen Sie für Ihre Schlüssel passende Saldolimits fest.

Der gleiche Gutschein kann höchstens gleichzeitig verarbeitet werden 2 Anfragen; Modellrufe sind ebenfalls durch die Frequenz begrenzt. Wenn du auf 429 triffst, warte und drücke esFalschaussageIdentifizieren Sie die Ursache und vermeiden Sie Hochfrequenzschleifen-Wiederholungen.

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.