De la connexion, dépôt et création des clés jusqu’à la première requête API en clair. Comprend des étapes complètes d’inspection, une vérification pratique et la gestion des erreurs.

Commençons

Cette page vous aide à commencer à utiliser le site via le chat ou les appels API. Le champ actuel des services est le suivant :Requêtes complètes et vérifiables en clair。

Découvrez-le sur le site web

1. Inscrivez-vous ou connectez-vous à ce compte du site.
2. OuvrePortefeuilleAprès avoir confirmé le montant Doken (WordKnife, DK) et le montant réel du paiement en RMB, rechargez via Alipay ou WeChat ; Le prix unitaire actuel est de 0,30 RMB/DK.
3. OuvreExpérience de discussionSélectionnez le modèle ouvert et soumettez d’abord une question courte en texte normal.
4. ExisterConsole de contrôleConsultez les relevés d’utilisation et de consommation.

Actuellement, la consommation est basée sur le solde ; aucun abonnement n’est requis. Merci de lire avant de recharger ou d’appeler le jeuRègles d’utilisation。

Créez une clé d’appel pour l’application

ExisterGestion cléCréer des clés API pour les appels de modèles ; Fixez les limites d’équilibre et de modèle selon les besoins réels, et stockez-les correctement après avoir économisé.

L’application utilise leClé d’appel de modèle, pas de mot de passe de connexion web. N’écrivez pas de clés dans du code public, des captures d’écran, du contenu de discussion ou du code frontal accessible via navigateur. Les clés fuitées doivent être révoquées et recréées dans la gestion des clés.

Configurer le client

Chaque client définit les adresses différemment : remplissez-les Base URL Elle est généralement conservée à cette époque /v1； Si vous devez remplir l’adresse complète du Chat, veuillez la remplir https://api.baiyun.si/v1/chat/completions。 Ne le range pas /v1 Répétez le raccordement deux fois. Tous les clients, plugins et fonctions ne sont pas compatibles par défaut.

La première requête API

Définissez les variables d’environnement sur le terminal local pour éviter d’entrer dans le terminal partagé ou l’écran d’enregistrement lors de la saisie de la clé :

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

Une requête réussie renvoie le texte généré et les informations d’utilisation, et déduit le solde DK du prix unitaire de référence affiché. 1 DK désigne le lot de jetons évalués à 1 USD selon des cotations de référence commerciales sélectionnées pour l’API, et non des quantités fixes de jetons ni de l’argent convertible en dollars américains. Les requêtes au-dessus de la normale génèrent également une petite quantité de consommation.

Le taux actuel de 0,30 RMB/DK correspond au prix de recharge sur ce site, et non au coût d’abonnement exact prouvé par des tests réels ; La valeur de référence et le coût d’abonnement pour le même lot de jetons sont indiqués en conversion en RMB ou JPYInstructions de facturation en trois étapes。

Si vous voulez recevoir des sorties en continu, vérifiezExemple de chat streaming； En utilisant Responses, l’application peut la consulterExemples de réponses。

Vérifiez les modèles appelables

L’interface de liste de modèles nécessite également une authentification clé :

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

Le modèle qui renvoie effectivement la clé courante prévaudra. Si le modèle n’existe pas ou n’est pas disponible, veuillez vérifier le nom du modèle, les limites de clé et l’équilibre, et ne retentez pas à plusieurs reprises les requêtes non prises en charge.

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.