Serverseitige Umgebungsvariablen, Antworten/Chat-SDK Mindestbeispiele und Wiederholungen. Beinhaltet vollständige Inspektionsschritte, praktische Überprüfung und Fehlerbehandlung.

Python, Node.js und LangChain

Der Server speichert den Schlüssel

Der Schlüssel durchläuft Prozessumgebungsvariablen BAIYUN_API_KEY Lies es. Browser-Webseiten und mobile Apps können keine integrierten gemeinsamen Schlüssel haben; Du brauchst deine eigene Backend-Authentifizierung und Quote, um die Anfrage in deinem Namen zu senden. Vor der Bereitstellung prüfen Sie, ob die Logs Anfrage-Header oder Umgebungsvariablen drucken.

Python

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["BAIYUN_API_KEY"],
                base_url="https://api.baiyun.si/v1",
                timeout=120.0, max_retries=0)
response = client.responses.create(model="gpt-6-luna",
                                   input="用一句话说明 Token 是什么。")
print(response.output_text)

output_text Es ist die Bequemlichkeit, die das SDK bietet; Beim direkten Parsen von REST JSON sollte es durchquert werden output Textfeld im Nachrichteneintrag. Abhängigkeiten sollten in einer isolierten Umgebung installiert und die Projektsperrdateien erhalten bleiben; Upgrade nicht das gesamte Produktionsprojekt nur zum Testen.

Node.js

import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.BAIYUN_API_KEY,
  baseURL: 'https://api.baiyun.si/v1',
  maxRetries: 0,
  timeout: 120000,
});
const stream = await client.chat.completions.create({
  model: 'gpt-6-luna', stream: true,
  messages: [{role: 'user', content: '你好'}],
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

LangChain

Verwenden Sie einen Modelladapter, der OpenAI-kompatible Adressen unterstützt, und setzen Sie den API-Schlüssel, die Basis-URL und das Modell in der aktuellen Version ein. Rufen Sie zuerst den Klartext auf, dann fügen Sie Links, Abruf oder Werkzeuge hinzu; Alle zusätzlichen Parameter, die vom Framework automatisch hinzugefügt werden, müssen weiterhin dem offenen Anwendungsbereich der Seite entsprechen; betrachten Sie den Framework-Namen nicht als Garantie der Kompatibilität.

Fehler und Wiederholungen

Unterscheide zunächst zwischen HTTP-State-, SDK-Parsingfehlern und Geschäftsrückgabefehlern. Erzeugungsunterbrechungen können bereits Geld verbrauchen; Versuchen Sie es nicht automatisch unendlich erneut; 429 Rückzug wie aufgefordert, 401 Reparaturausweise, 400 Reparaturparameter. Wenn die Verbindung abläuft, überprüfe die Statusseite und das Netzwerk, bevor du entscheidest, ob du es erneut versuchen möchtest.

Offizielles Python-SDK-Projekt · Offizielles Node-SDK-Projekt · Offizielle LangChain-Dokumentation

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 Fehlerbehebung: Getrennte Anfrageprobleme von Codeproblemen

Führe zuerst den minimalen Curl mit demselben Schlüssel und Modell aus und vergleiche dann die tatsächliche Adresse des SDK, das Anfrageprotokoll und die Parameter. Wenn Curl erfolgreich ist, aber das SDK fehlschlägt, solltest du die Proxy-Umgebung troubleshooten, SDK automatisch wiederholen, timeout und zusätzliche Felder durchführen. Drucken Sie die Autorisierung nicht in Fehlerprotokollen; Schlüssel während der Bereitstellung können nicht in Frontend-Build-Variablen geschrieben werden.

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.