Codes d’erreur API : corriger 401, 403, 404, 429 et 5xx

Signification des erreurs 401, 403, 404, 429 et 5xx de 88API et solutions : jeton invalide, solde insuffisant, limite de débit, erreurs Claude Code et Codex.

Lorsqu'un appel échoue, l'API renvoie un code de statut HTTP et un corps JSON. La cause de l'erreur figure dans error.message :

{
  "error": {
    "code": "",
    "message": "Invalid token (request id: 2026101605444223...)",
    "type": "new_api_error"
  }
}

Le request id à la fin de message est le numéro de cette requête ; communiquez-le lorsque vous contactez le service client. La page Journal d'utilisation de la console enregistre aussi l'heure, le modèle et le message d'erreur des requêtes en échec. Pour diagnostiquer, regardez d'abord le code de statut, puis le message.

Les messages d’erreur suivent la langue enregistrée dans votre profil (ou l’en-tête Accept-Language du client). Sinon, ils peuvent être renvoyés en chinois ; leur signification reste celle décrite ci-dessous.

Tableau récapitulatif

Code de statut	Signification	Que faire en premier
400	Le contenu ou les paramètres de la requête ne sont pas acceptés par le modèle	Corrigez les paramètres, le prompt ou l'image selon le message d'erreur
401	Jeton invalide	Vérifiez que la clé API est correctement saisie et qu'elle n'a pas été supprimée
403	Jeton indisponible, solde insuffisant ou absence d'autorisation	Vérifiez le solde, l'état du jeton, ainsi que le groupe et les restrictions de modèles du jeton
404	L'adresse ou le modèle n'existe pas	Vérifiez si l'adresse de l'API contient un `/v1` en trop et si le nom du modèle est disponible dans le groupe actuel
429	Trop de requêtes ou modèle saturé	Réduisez la fréquence et réessayez plus tard
500, 502, 503, 504, 524	Service du modèle temporairement indisponible ou délai dépassé	Réessayez plus tard ; si l'échec persiste, changez de groupe ou de modèle

401 : jeton invalide

Messages courants : Invalid token, 无效的令牌 (jeton invalide).

La clé API a été copiée de façon incomplète, ou contient des espaces ou des retours à la ligne au début ou à la fin.
Le jeton a été supprimé dans la console. Créez-en un nouveau ou copiez-le à nouveau sur la page Jeton API.
Claude Code : une ancienne variable ANTHROPIC_API_KEY est aussi définie. Elle est prioritaire sur ANTHROPIC_AUTH_TOKEN ; supprimez-la et ne gardez que ANTHROPIC_AUTH_TOKEN.
Format de l'en-tête de requête : le format OpenAI utilise Authorization: Bearer sk-... ; le format Anthropic utilise x-api-key: sk-....

403 : jeton indisponible, solde insuffisant ou absence d'autorisation

Solde ou quota insuffisant

Messages courants : Insufficient user quota, Not enough quota to pre-consume for this request: … remaining, … required.

Le solde du compte ne couvre pas la pré-facturation de cette requête. Rechargez votre compte sur la page Portefeuille.
Le compte a du solde mais le message d'insuffisance s'affiche quand même : un jeton peut avoir son propre plafond de quota ; vérifiez le quota restant de ce jeton.
Claude Code affiche ce type de 403 comme un échec d'authentification ou « API Error 403 » ; la solution est la même.

État du jeton indisponible

Message courant : This token status is unavailable.

Le jeton est désactivé, a expiré ou a épuisé son quota. Sur la page Jeton API, activez le jeton, modifiez sa date d'expiration ou ajustez son quota.

Pas d'autorisation pour le groupe ou le modèle

Messages courants : No permission to access group …, API Key 所属专属分组不再允许当前用户使用 (le groupe dédié auquel appartient cette clé API n'est plus accessible à l'utilisateur actuel), This token has no access to model ….

Le compte actuel ne peut pas utiliser le groupe associé au jeton : modifiez le jeton et choisissez un groupe disponible dans la Place des modèles.
Le jeton a des restrictions de modèles : autorisez le modèle concerné dans les paramètres du jeton, ou utilisez un autre jeton.

Le groupe actuel ne prend pas en charge cette interface

Message courant : This group does not allow /v1/messages dispatch.

Le groupe sélectionné ne prend pas en charge les interfaces de ce protocole (par exemple, appeler /v1/messages d'Anthropic avec un groupe qui ne prend en charge que le format OpenAI). Pour Claude Code, utilisez un jeton d'un groupe Claude ; pour les autres clients, appelez le type d'interface que le modèle prend en charge selon la Place des modèles.

404 : l'adresse ou le modèle n'existe pas

/v1 en trop ou manquant dans l'adresse

Messages courants : Invalid URL, 404 page not found.

Pour Claude Code, ANTHROPIC_BASE_URL doit valoir https://api.88api.ai, sans /v1 (Claude Code ajoute lui-même /v1/messages ; avec .../v1, on obtient /v1/v1/messages).
Pour Codex, base_url doit valoir https://api.88api.ai/v1, avec /v1 obligatoirement.
La plupart des applications compatibles OpenAI utilisent https://api.88api.ai/v1. Pour chaque application, voir les guides de connexion des applications.

Le modèle n'est pas disponible dans le groupe actuel

Messages courants : No available channel for model … under group …, Model "…" is not supported by any configured account in this group, model not found.

Le nom du modèle est mal orthographié, ou comporte un préfixe ou suffixe en trop. Copiez le nom exact du modèle depuis les Paramètres du profil ou la Place des modèles.
Le modèle ne fait pas partie du groupe choisi pour le jeton. Consultez dans la Place des modèles les groupes qui prennent en charge le modèle, puis modifiez le groupe du jeton.

400 : contenu ou paramètres de la requête non acceptés

Message d'erreur (exemples)	Cause et solution
`输入内容超过模型上下文限制` (l'entrée dépasse la limite de contexte du modèle), `Input exceeds the context limit`	La conversation est trop longue. Réduisez l'historique ou ouvrez une nouvelle session ; dans Claude Code, vous pouvez utiliser `/compact` pour compresser le contexte
`请求中包含该模型不支持的参数（如 presence_penalty / frequency_penalty）` (la requête contient des paramètres non pris en charge par ce modèle, comme presence_penalty / frequency_penalty)	Supprimez le paramètre mentionné dans l'erreur
`该模型是生图模型，不能通过对话接口调用` (ce modèle est un modèle de génération d'images et ne peut pas être appelé via l'interface de discussion)	Pour générer des images, utilisez `/v1/images/generations` ; pour les modifier, `/v1/images/edits`. Voir API image
`please use the Gemini native API`	Ce modèle ne prend en charge que le format natif Gemini. Voir API Gemini
`the selected model cannot disable reasoning`, `不支持关闭深度思考` (la désactivation de la réflexion approfondie n'est pas prise en charge)	Ce modèle doit avoir la réflexion activée. Supprimez le paramètre qui la désactive (ou définissez le type de réflexion sur enabled)
`requires adaptive thinking`	Ce modèle Claude exige la réflexion adaptative : supprimez le paramètre `thinking`, ou passez-le à `type=adaptive` comme l'indique l'erreur
`当前输入触发平台内容安全规则` (l'entrée a déclenché les règles de sécurité du contenu de la plateforme), `未通过内容安全审核` (échec de la modération de sécurité du contenu), `可能违反了…内容政策` (peut enfreindre la politique de contenu de …)	Le prompt ou l'image de référence a été bloqué par la modération. Modifiez le contenu puis réessayez
`Failed to download multimodal content`, `mime type is not supported`	L'URL de l'image est inaccessible ou le format n'est pas pris en charge. Utilisez une image PNG, JPEG ou WebP accessible publiquement, ou envoyez-la en base64

429 : trop de requêtes ou saturation

Limite de fréquence des requêtes du compte dépassée

Message courant : Your request rate is too high. The current user group allows up to … successful requests within a …-minute window.

La limite par défaut est de 60 RPM (requêtes par minute). Réduisez la concurrence ou ajoutez des intervalles entre les tentatives dans votre client ; si vous avez réellement besoin d'une fréquence plus élevée, contactez le service client pour demander une augmentation.

Modèle saturé

Messages courants : Upstream rate limit exceeded, service error, please try again later, Concurrency limit exceeded.

Le modèle reçoit actuellement beaucoup de requêtes. Patientez quelques secondes puis réessayez ; pour plus de stabilité, changez de groupe dans la Place des modèles.

500, 502, 503, 504, 524 : service temporairement indisponible ou délai dépassé

Messages courants : Upstream service temporarily unavailable, Service temporarily unavailable. Please retry., 系统过载，请稍后重试 (système surchargé, veuillez réessayer plus tard), 模型请求失败，请稍后重试或更换模型 (échec de la requête au modèle, veuillez réessayer plus tard ou changer de modèle), bad response status code 504.

Ces erreurs viennent le plus souvent d'une saturation passagère du service du modèle ou de fluctuations réseau ; une nouvelle tentative suffit généralement. Nous recommandons de réessayer côté client avec des intervalles croissants de 1, 2 puis 4 secondes.
Si le même modèle échoue de manière persistante, changez de groupe ou de modèle.
Les erreurs 524 et 504 surviennent surtout sur les requêtes dont la génération est longue : activez la sortie en streaming (stream: true) pour les requêtes de discussion ; pour les images et les vidéos, utilisez les interfaces de tâches asynchrones et interrogez régulièrement le résultat.

Le problème persiste

Retrouvez l'enregistrement en échec dans le Journal d'utilisation et envoyez l'heure de la requête, le nom du modèle, le code de statut et le message d'erreur complet (avec le request id) au service client en ligne. N'envoyez pas votre clé API complète.

Codes d'erreur et erreurs courantes