Variables d’environnement côté serveur, exemples minimums de réponses SDK et de réessayages. Comprend des étapes complètes d’inspection, une vérification pratique et la gestion des erreurs.

Python, Node.js et LangChain

Le serveur stocke la clé

La clé passe à travers les variables de l’environnement du processus BAIYUN_API_KEY Lis-le. Les pages web du navigateur et les applications mobiles ne peuvent pas avoir de clés partagées intégrées ; Vous devez avoir votre propre authentification backend et un quota pour envoyer la requête en votre nom. Avant le déploiement, vérifiez si les journaux impriment des en-têtes de requête ou des variables d’environnement.

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 C’est la commodité offerte par le SDK ; Lors de l’analyse directe du JSON REST, il faut le traverser output Champ texte dans l’élément du message. Les dépendances doivent être installées dans un environnement isolé et les fichiers de verrouillage du projet conservés ; Ne mettez pas à jour tout le projet de production juste pour les tests.

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

Utilisez un adaptateur modèle qui prend en charge les adresses compatibles OpenAI, et définissez la clé API, l’URL de base et le modèle dans sa version actuelle. Appelez d’abord le texte brut, puis ajoutez des liens, des recherches ou des outils ; Tout paramètre supplémentaire ajouté automatiquement par le cadre doit toujours respecter le champ d’application ouvert du site ; ne considérez pas le nom du cadre comme une garantie de compatibilité.

Erreurs et réessais

Tout d’abord, distinguez entre l’état HTTP, les erreurs d’analyse du SDK et les erreurs de retour métier. Les interruptions de génération peuvent déjà consommer de l’argent ; ne réessaient pas automatiquement à l’infini ; 429 Retraite comme demandé, 401 Identifiants de réparation, 400 Paramètres de réparation. Lorsque la connexion expire, vérifiez la page d’état et le réseau avant de décider de réessayer.

Projet SDK Python officiel · Projet officiel du SDK Node · Documentation officielle de LangChain

Liste de contrôle avant utilisation pratique

1. Préparez votre propre compte et vos clés d’accès, et n’utilisez pas les identifiants partagés des autres.
2. Enregistre les versions, systèmes et modèles clients pour faciliter la reproduction lors du dépannage.
3. Sauvegardez la configuration originale ou la capture d’écran, masquez les clés, les codes de vérification et le contenu privé.
4. Confirmez que les tests peuvent consommer une petite quantité de DK, en commençant par une seule phrase et une seule demande.
5. Examinez la place du modèle actuel et la page d’état avant de décider d’activer d’autres fonctionnalités.

Dépannage détaillé : séparer les problèmes de requête des problèmes de code

D’abord, exécutez le curl minimum avec la même clé et le même modèle, puis comparez l’adresse réelle du SDK, le protocole de requête et les paramètres. Si le curl réussit mais que le SDK échoue, dépannez l’environnement proxy, l’auto-réessai du SDK, le délai d’expiration et des champs supplémentaires. N’imprimez pas l’autorisation dans les journaux d’erreur ; Les clés pendant le déploiement ne peuvent pas être écrites dans les variables de construction frontend.

Comment confirmer que cette section a été apprise

Ne vous contentez pas de cocher l’invite « Configuration sauvegardée avec succès ». Vous devriez pouvoir indiquer clairement l’URL de base actuelle, l’utilisation des clés, le modèle choisi et le protocole de requête, et pouvoir vérifier vos résultats d’opération sur la console correspondante. Le tutoriel côté client utilise une seule réponse en texte brut et les journaux correspondants comme norme initiale de complétion ; Les tutoriels de compte reposent sur des informations de sécurité complètes ; Le tutoriel de facturation utilise la correspondance entre le principal, les frais de chaîne et DK comme norme.

Si une erreur survient, notez l’heure d’occurrence, l’état HTTP, le contenu de l’erreur anonymisée et le résultat réel attendu. Ne faites pas de capture d’écran de la clé de la page entière, et ne donnez pas le mot de passe ou le code de vérification à d’autres. Pour 401, l’authentification doit être résolue en premier ; pour 400, les paramètres doivent être résolus en premier ; pour 429, les tentatives intensives doivent être arrêtées ; pour 404, les chemins de requête et la vérification en amont doivent être vérifiés ; la recharge ne peut pas résoudre toutes les erreurs.

Une petite tâche adaptée à la pratique

Complétez les étapes minimales de cette section dans votre propre environnement de test, en notant dans le texte « comment vous l’avez initialement configuré, quel élément vous avez modifié et quels résultats vous avez obtenus. » Ne considérez pas les données de production, les paiements réels ou les commandes irrécupérables comme des exercices. Si vous rencontrez des fonctionnalités au-delà de ce que propose cette section, consultez d’abord le tutoriel de protocole correspondant avant d’envisager d’ajouter des fonctionnalités ; Ne changer qu’une seule configuration à la fois facilite la mesure de la décision de savoir quelle étape entraîne des erreurs.

L’étape suivante est la frontière de la version

Retour à la carte d’apprentissage complète · Configuration simplifiée du site API · Statut en temps réel de ce site。

Le tutoriel a été compilé le 9 octobre 2026. L’interface spécifique et les capacités peuvent varier selon le client et les versions en amont ; Les directives de configuration ne signifient pas que toutes les versions clients ont réussi le test. Pour les paiements de solde, la connexion QQ / Alipay et les canaux ouverts, veuillez consulter la page de la page réelle ; Interfaces de compression : Auparavant, les canaux d’image 404 et bruts en amont n’étaient pas disponibles, donc ne supposez pas que les fichiers de configuration peuvent être supprimés automatiquement.