Erreurs courantes & solutions
Pas de panique face à un message d'erreur — ci-dessous, le classement se fait « selon le message que vous voyez », avec pour chaque cas la cause et ce que vous devez faire. Le plus rapide est de chercher un mot-clé avec Ctrl/⌘ + F dans votre navigateur.
401 / invalid token / jeton invalide
Cause : un problème avec la clé API (le jeton). Le plus souvent :
- La clé a été mal copiée (un espace en trop, un caractère manquant)
- La clé a été supprimée ou désactivée dans la console
- Elle n'est pas renseignée au bon endroit dans le client, ou il manque le
Bearer
Que faire :
- Retournez dans Console → Jetons pour vérifier que ce jeton existe toujours et que son statut est normal.
- Recopiez-le une nouvelle fois, en remplaçant tout le bloc, et veillez à ne pas laisser d'espace au début ou à la fin.
- Vérifiez que
base_urlest également correctement renseigné (voir les tutoriels propres à chaque client).
Solde insuffisant / insufficient quota / INSUFFICIENT_BALANCE
Cause : le solde du compte ou le quota de ce jeton est épuisé.
Que faire : rechargez votre compte depuis la Console ; ou vérifiez si ce jeton a un plafond de quota défini, et augmentez-le.
Le rechargement n'apparaît pas ?
Les rechargements en USDT / crypto doivent être réglés selon le montant exact affiché sur la page (un paiement en trop ou en moins ne sera pas crédité automatiquement). En cas d'erreur de montant, pas d'inquiétude : faites une capture d'écran de la preuve de paiement et contactez le service client pour un traitement manuel.
Aucun canal disponible / aucun canal disponible pour le groupe actuel / no available channel
Cause : le modèle que vous demandez n'a pas de canal correspondant dans le groupe auquel appartient votre compte. Cela arrive souvent lorsqu'on indique le nom d'un modèle que nous ne proposons pas, ou qui n'est pas inclus dans votre forfait.
Que faire :
- Ouvrez la Console pour consulter la liste des modèles actuellement disponibles, et choisissez-en un qui y figure.
- Vérifiez que le nom du modèle est orthographié exactement de la même manière (majuscules/minuscules, tirets : tout doit correspondre).
- Si l'erreur persiste alors que tout semble correct → il s'agit peut-être d'un problème de droits liés à votre groupe : contactez le service client pour confirmation.
Modèle inexistant / model_not_found
Cause : le nom du modèle est mal orthographié, ou ce modèle ne fait pas partie de votre groupe.
Que faire : comme au point précédent — rendez-vous dans la console, et reportez le nom dans votre client à la lettre près, en vous appuyant sur la liste des modèles.
Flux interrompu / stream disconnected / Connection error / forte charge
Cause :
- L'upstream est saturé en période de pointe, ou une instabilité réseau passagère survient
- Une connexion directe depuis la Chine vers les serveurs en Allemagne : le lien est parfois instable
Que faire :
- Réessayez tout simplement une fois : dans la plupart des cas, cela passe.
- Si cela revient fréquemment → essayez un autre modèle (les différents modèles passent par des upstreams différents).
- Si le problème persiste → faites une capture d'écran et contactez le service client ; nous vérifierons l'état des canaux côté backend.
Délai d'attente dépassé / timeout
Cause : il s'agit le plus souvent d'un problème réseau, en particulier pour une connexion directe depuis la Chine vers l'étranger.
Que faire : réessayez ; si la lenteur dure, nous vous recommandons d'utiliser un accélérateur / de passer par un proxy avant de vous reconnecter.
reasoning / l'intensité de réflexion ne s'applique pas
Cause : les deux interfaces n'utilisent pas la même syntaxe ; les mélanger fait que le réglage est ignoré.
| Interface | Syntaxe correcte |
|---|---|
/v1/chat/completions | chaîne de caractères : "reasoning_effort": "high" |
/v1/responses (Codex, etc.) | objet : "reasoning": { "effort": "high" } |
Que faire : choisissez la syntaxe correspondant à l'interface que vous utilisez. Dans Codex, utilisez directement l'option de configuration model_reasoning_effort, sans avoir à l'écrire à la main.
Page de la console en 500 / écran blanc / erreur à chaque clic
Cause : la traduction Google activée dans le navigateur (traduction automatique de toute la page) entre en conflit avec la console et provoque des erreurs au clic.
Que faire :
- Désactivez la traduction Google sur cette page (icône de traduction dans la barre d'adresse → afficher le texte original), puis actualisez.
- Nous avons déjà ajouté une protection côté serveur, mais nous recommandons malgré tout de ne pas activer la traduction de page entière sur ce type de console.
Connu et déjà renforcé
Nous avons déjà mis en place une prise en charge pour ce problème. Si vous le rencontrez encore après une mise à jour, désactiver la traduction et actualiser une fois suffit généralement.
Toujours bloqué ?
Envoyez au service client une capture d'écran du message d'erreur d'origine + le client et le modèle que vous utilisez : ce sera bien plus rapide qu'une description orale.
