Tutoriel API Baiyun : erreurs courantes et 429
Méthodes pour dépanner les codes d’erreur, authentification, limitation de débit, blocages temporaires, interfaces et problèmes de frais. Comprend des étapes complètes d’inspection, une vérification pratique et la gestion des erreurs.
Erreurs courantes avec 429
En cas d’erreurs, vérifiez d’abord le statut HTTP et la version retournée error.message、error.code et numéro de demande. Le même code de statut peut provenir de différentes étapes, et la cause profonde ne peut pas être confirmée uniquement par des chiffres.
État commun
| Statut | Raisons possibles | Suggestion |
|---|---|---|
| 400 | Les champs, formats ou fonctions de requête ne sont pas disponibles | Consultez les exemples textuels sur ce site et supprimez automatiquement les outils, fichiers et champs médias ajoutés par le client |
| 401 | Les clés sont manquantes, invalides ou incorrectes | Vérifiez le format Bearer et la clé du site ; vous n’avez pas besoin de mot de passe de connexion web pour appeler le modèle |
| 403 | Autorisations, refus de règles d’utilisation ou suspension temporaire des identifiants | Lisez les instructions spécifiques et cessez de soumettre à plusieurs reprises du contenu interdit ; Des confinements temporaires attendent leur rétablissement |
| 413 | Trop demander | Raccourcir l’historique des conversations et les textos ; la limite actuelle de corps de la demande est de 1 Mio |
| 429 | Concurrence concurrente, fréquence ou limites en amont | Attendez un peu, jugez en fonction du contenu spécifique de l’erreur, et n’essayez pas indéfiniment |
| 500 / 502 / 503 | Les services ou services en amont sont temporairement indisponibles, et les réponses complètes n’ont pas été obtenues | Conservez le numéro de la demande et l’heure, avec des tentatives limitées plus tard |
Les erreurs métier telles que l’équilibre insuffisant, les modèles indisponibles ou les tarifs non configurés doivent également être lues et renvoyées au texte principal ; vous ne pouvez pas simplement consulter les codes d’état ou les fenêtres contextuelles frontales.
429 Ce n’est pas forcément que vous « demandez trop »
429 indique qu’une certaine couche restreint la requête. Actuellement, chaque accréditation peut être traitée au maximum simultanément 2 demandes, la limite de fréquence de l’appel du modèle est 60 battements par minute; L’amont a aussi ses propres limites de ressources et d’utilisation.
concurrency_limit: Attendre que la requête existante soit terminée avant d’envoyer la suivante. Les requêtes de flux restent en concurrence jusqu’à leur fin.- Limite de fréquence régulière ou 429 en amont : respect
Retry-After(Si disponible), utilisez un nombre limité de réessais avec des délais d’attente progressivement allongés afin d’éviter les demandes répétées immédiates. - La page affiche directement HTTP ERREUR 429 : Les requêtes de page du navigateur peuvent également être restreintes ; Attendez un instant avant de rafraîchir ; si cela continue, gardez l’heure et le chemin d’occurrence pour l’administrateur.
Si un problème de texte normal est mal jugé, le numéro de demande et les notes non sensibles nécessaires peuvent être fournis pour examen ; N’envoyez pas les clés, mots de passe disponibles ni les textes originaux sensibles complets.
403 Scellement temporaire avec bons
content_policy_violation Cela indique que cette demande a respecté les restrictions d’utilisation du site et a été rejetée avant d’être envoyée en amont.
credential_temporarily_blocked Retour 403, et fournissent Retry-After Prompt d’attente : Après que la même certification ait appliqué la règle plusieurs fois dans les 30 minutes, faites une pause de 30 minutes. Veuillez arrêter le contenu associé et attendre la récupération ; ne continuez pas en changeant la clé. Cela diffère de la concurrence 429 ou de la limitation de fréquence.
Problèmes d’adresse d’interface et de modèle
L’URL de base devrait être https://api.baiyun.si/v1, l’adresse complète du chat est /v1/chat/completions, Les réponses abordent : /v1/responses。 Vérifier la présence de doublons /v1/v1, et si le client a sélectionné des protocoles non ouverts sur ce site.
Le nom du modèle doit être associé àModèle Carréet la tonalité actuelle /v1/models Retournez de manière cohérente ; n’utilisez pas d’alias d’affichage côté client pour remplacer le nom d’appel réel.
Problèmes de streaming et de coûts
Chat SSE devrait lire [DONE]; Réponses SSE doit lire la fin complète de l’événement. Certains textes après une déconnexion réseau ne peuvent pas être considérés comme une réponse complète et réussie.
Les paramètres d’entrée et de sortie ne garantissent pas un plafond de coût strict. Les requêtes normales, les échecs après saisie en amont ou les annulations clients doivent être vérifiés par rapport aux enregistrements de consommation réels ; Seules les requêtes rejetées localement et sans montée en amont ne seront pas facturées pour cet appel modèle.
Que sont fournis lors de l’inspection ?
- Heure et fuseau horaire.
- Numéro de requête, nom du modèle, chemin d’interface et statut HTTP.
- Messages d’erreur après suppression de clés et de contenu sensible.
- Pour les questions de paiement, fournissez le numéro de commande et le statut, mais ne fournissez pas la clé du commerçant de paiement.
La station continue de progresser progressivement et n’a pas encore adopté une réponse manuelle 24h/24 ni des limites de temps de traitement fixes.
Liste de contrôle avant utilisation pratique
- Préparez votre propre compte et vos clés d’accès, et n’utilisez pas les identifiants partagés des autres.
- Enregistre les versions, systèmes et modèles clients pour faciliter la reproduction lors du dépannage.
- Sauvegardez la configuration originale ou la capture d’écran, masquez les clés, les codes de vérification et le contenu privé.
- Confirmez que les tests peuvent consommer une petite quantité de DK, en commençant par une seule phrase et une seule demande.
- 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.