Baiyun Super Intelligence BAIYUN.SI
Tutoriel d’intégration API

Tutoriel API Baiyun : Interface de chat texte

Lecture gratuite

Exemple de synchronisation des Chat Completions avec le streaming SSE, requêtes en texte brut. Comprend des étapes complètes d’inspection, une vérification pratique et la gestion des erreurs.

Interface textuelle Chat Completions

Adresse de l’interface :POST https://api.baiyun.si/v1/chat/completions。

Actuellement, des conversations en texte clair de type Chat sont disponibles pour les clients qui prennent explicitement en charge le protocole Chat d’OpenAI. Demandez à utiliser la clé du site et soumettez le texte intégral requis pour cette conversation.

Structure des requêtes

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

model C’est le nom du modèle réellement disponible sur ce site ;messages Messages texte soumis dans l’ordre ;stream Décidez si vous revenez de façon synchrone ou si vous diffusez en streaming. Cet article présente uniquement la structure de texte de base ouverte ; les paramètres complexes du SDK et les fonctionnalités d’extension ne devraient pas être disponibles par défaut.

Appel synchrone

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}'

Le texte généré se trouve à choices[].message.content; Les informations sur la posologie sont disponibles ici usage。 Le contenu spécifique, le nombre de jetons et les frais sont soumis aux réactions réelles et aux relevés de consommation de cette période.

Appels de flux

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}
  }'

Retour de flux en utilisant SSE : lecture data: JSON, concaténez-les dans l’ordre choices[].delta.content。data: [DONE] Indique la fin du ruisseau ; Activé include_usage Le message d’utilisation à la fin doit être conservé ensuite. Ne traitez pas chaque shard SSE comme une réponse HTTP autonome.

Contexte du dialogue et limites des paramètres

Le canal actuel utilise l’échantillonnage par défaut du modèle.temperature、top_p、frequency_penalty Et presence_penalty Des commandes réglables ne sont pas fournies pour le moment ; Les valeurs par défaut courantes côté client sont supprimées par le traitement de compatibilité et ne modifient pas les paramètres d’échantillonnage du modèle.

Plusieurs tours de dialogue doivent être présents messages Soumettez l’historique complet du texte requis. Actuellement, les outils externes, le réseau, les images et les fonctions de fichiers sont suspendus, et il est impossible de contourner les soumissions de texte via un historique externe non vérifié.

Certains modèles ou clients prennent en charge les paramètres de sortie différemment. Même si vous demandez de le remplir max_tokens、max_completion_tokens Ou des valeurs comme 8192, etcIl ne peut pas être considéré comme une durée de production fixe ou une limite de coût garantie par ce site。 Commencez par une brève demande, vérifiez vos factures de dépenses et fixez des limites de solde pour vos clés qui vous conviennent.

Le même bon peut être traité au maximum simultanément 2 demandes; Les appels modèles sont également limités par la fréquence. Si vous tombez sur 429, attendez et appuyez dessusDéclaration erronéeIdentifiez la cause et évitez les retentatives de boucle à haute fréquence.

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.

Enquête détaillée : réduire l’étendue du problème dans l’ordre

D’abord, confirmez que le compte est complet, que la clé est valide et que le solde DK est suffisant, puis vérifiez le protocole, l’adresse et le modèle. Faites une demande de texte minimale en utilisant la même clé ; Ce n’est qu’après son succès qu’il restaure les pièces jointes, les outils, ou réessaie automatiquement chaque objet. Après avoir sauvegardé la configuration client, rouvrez la session pour éviter d’utiliser le fournisseur précédent dans l’ancienne session.

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.

Une fois que tu l’as appris, essaie.

Utilisez les 100 questions de SIN1 pour vérifier votre fond de teint.

Faites le test

Contactez la communauté Baiyun SI

Contactez par email.

Pour toute demande, échange de besoins ou discussions de coopération, veuillez envoyer un e-mail.