Sur cette page
Erreurs courantes
Erreurs que tout outil d'agent peut rencontrer en se connectant à HiAPI, et comment les corriger.
Chaque guide d’outil ne liste que les erreurs propres à cet outil. Celles-ci peuvent survenir avec n’importe quel outil. Vérifiez d’abord le code de statut ou le mot-clé dans l’erreur, puis cherchez-le dans le tableau ci-dessous :
| Erreur | Cause | Correction |
|---|---|---|
| 401 / invalid api key | La clé est incomplète, comporte des espaces avant ou après, ou vous avez copié la valeur masquée affichée | Allez dans API Keys, cliquez sur l’icône de copie et copiez à nouveau la clé API HiAPI complète |
| L’erreur mentionne le solde, le quota ou un plafond de dépenses | Le solde du compte est trop faible, ou le plafond de dépenses de cette clé est épuisé | Rechargez dans Solde du compte, ou augmentez le plafond de dépenses de cette clé sur la page API Keys |
| 403 | Cette clé n’a pas la permission d’accéder au modèle | Vérifiez le groupe et les permissions de la clé, voir Authentification |
| 404 / model not available | La Base URL contient un /v1 en trop ou manquant, ou le nom du modèle est mal orthographié | Vérifiez l’URL avec Base URL et protocoles ; copiez le nom du modèle depuis la liste des modèles texte |
| 400 does not support this endpoint | Le protocole sélectionné dans l’outil n’est pas pris en charge par ce modèle | Essayez un autre protocole (par exemple Anthropic Messages pour Claude), ou passez à un autre modèle |
| 400 stream must be true / réponse bloquée indéfiniment | Le modèle fonctionne uniquement en streaming et l’outil a envoyé une requête non streaming | Activez le streaming dans l’outil. Si le bouton « Check » ou « Test connection » de l’outil renvoie cette erreur, ignorez-la et fiez-vous à une vraie conversation |
| 429 | Trop de requêtes ou trop de simultanéité | Attendez et réessayez, et lancez moins de tâches à la fois ; si l’erreur mentionne un quota, suivez la ligne « solde, quota » ci-dessus |
| 500 / 502 / 503 | Le service du modèle a échoué temporairement | Attendez une ou deux minutes et réessayez ; si cela persiste, essayez d’abord un autre modèle, puis contactez-nous |
| Délai dépassé / réponse interrompue | Le réseau ou un proxy a bloqué la connexion longue durée | Vérifiez le réseau et les règles du proxy pour api.hiapi.ai, puis réessayez |
Vérifier le journal des requêtes avant de réessayer
Une tâche d’agent peut déjà être terminée côté serveur, seule la connexion de l’outil ayant été coupée. Avant de réessayer, consultez Journal des requêtes pour savoir si cette requête a réussi et combien elle a coûté, afin de ne pas payer deux fois le même travail.
Toujours bloqué
Soumettez un ticket sur Nous contacter avec les informations ci-dessous ; cela nous aide à localiser le problème plus vite :
- L’heure de l’erreur (à la minute près)
- L’outil et la version utilisés, par exemple Claude Code 2.1.284
- Le nom du modèle et la Base URL
- Le texte d’erreur d’origine ou une capture d’écran
Masquez la clé API avant de prendre une capture d’écran, et ne transmettez jamais la clé à quiconque, y compris au support.