Skip to main content
Cette page s’applique à Claude Code, Codex CLI, Cursor, extensions VS Code et applications maison. Avant toute nouvelle tentative, conservez le message d’erreur, le Request ID, l’heure, le modèle et l’endpoint appelé. Ne communiquez jamais une clé API complète.
Diagnostiquez avant de réessayerLes problèmes de paramètres, d’endpoint et de compatibilité de session ne disparaissent pas en répétant la requête. Ne réessayez qu’une seule fois, à faible fréquence, lorsqu’une panne transitoire est plausible.

​
status_code=500, not implemented

Si le message contient status_code=500 et not implemented, vérifiez d’abord que le modèle sélectionné prend en charge le protocole de l’endpoint appelé. Par exemple, /v1/responses requiert openai-response dans supported_endpoint_types. En l’absence de ce type, il s’agit d’une incompatibilité de protocole, pas d’une indisponibilité temporaire.
  1. Dans une application maison, choisissez l’endpoint selon supported_endpoint_types ; utilisez /v1/chat/completions lorsqu’il contient openai.
  2. Dans Claude Code, suivez le guide Claude Code et vérifiez que le modèle prend en charge anthropic.
  3. Choisissez l’endpoint correspondant avant un nouvel essai : attendre ou changer de réseau ne corrige pas ce problème.
Pour le support, fournissez un exemple expurgé, le modèle et le Request ID, jamais la clé.

​
400 Bad Request / paramètres incompatibles

Une 400 indique généralement un format de requête, un paramètre ou un état de session non valide pour l’endpoint.
  1. Recopiez l’ID exact du modèle depuis le catalogue.
  2. Vérifiez le couple endpoint/modèle/client dans l’aperçu d’intégration.
  3. Vérifiez la compatibilité des paramètres image, outils, raisonnement ou reprise de session.
  4. Mettez à jour un client ou SDK ancien.
  5. Créez une nouvelle session et envoyez un texte court.
Après avoir corrigé la cause probable, faites une requête minimale pour vérifier le résultat.

​
401 Unauthorized

Les causes habituelles sont une clé absente, incorrecte, désactivée, expirée ou un en-tête d’authentification mal formé.
Recopiez la clé depuis la console et vérifiez l’URL. Ne donnez pas sa valeur complète au support. En cas de fuite présumée, désactivez l’ancienne clé, créez-en une nouvelle et mettez à jour l’application.

​
403 Forbidden

Une 403 signifie que cette requête est refusée : groupe non autorisé, restriction de modèle, liste d’IP non correspondante, état du compte ou refus du service upstream. Vérifiez le groupe, les restrictions de modèle et la liste d’IP, puis testez une courte requête texte. Si l’erreur persiste, fournissez Request ID, modèle, heure et message original. Des essais fréquents ou la création de nouvelles clés ne résolvent pas une restriction d’accès.

​
404 Not Found / mauvaise adresse

Vérifiez en priorité :
  • que la Base URL n’est pas devenue /v1/v1/... ;
  • que le client n’ajoute pas déjà /v1 ou le chemin ;
  • que vous utilisez /v1/chat/completions, /v1/responses, /v1/messages ou /v1/images/generations selon le cas.
Les règles diffèrent par outil : consultez le guide de l’outil. Un modèle indisponible n’est généralement pas une 404. Un modèle absent du groupe, temporairement indisponible ou sans service disponible produit plus souvent 503 / no available channel.

​
429 Too Many Requests

Une 429 peut venir d’une limite de débit ou du modèle. Concurrency limit exceeded for user signale généralement une limite de concurrence du client ou de l’upstream ; le seul code HTTP ne prouve pas une panne de clé.
  • Réduisez la concurrence ; respectez Retry-After, sinon utilisez un backoff exponentiel avec jitter.
  • Ne faites pas réessayer rapidement plusieurs programmes avec la même clé.
  • Si l’erreur persiste à faible cadence, transmettez le Request ID.

​
500, 502, 503, 504 ou 524

Hors incompatibilité not implemented, ces codes indiquent souvent un échec de traitement, une rupture de connexion, un service occupé ou un délai d’attente. Ils ne signifient pas forcément que la clé ou le prompt est incorrect. En cas d’échecs répétés du même modèle, suspendez les longues tâches supplémentaires, conservez les informations et contactez le support.

​
no available channel / aucun service actuel pour ce modèle

Le groupe de la clé actuelle n’a temporairement aucun service disponible pour ce modèle. Un ID mal saisi, un modèle non proposé dans ce groupe, une indisponibilité temporaire ou une maintenance peuvent produire ce message. Réessayez plus tard ou choisissez un autre modèle visible pour ce groupe. Si cela persiste, envoyez le nom du modèle, le Request ID et l’heure ; ce message n’est pas lié à l’ajout de crédit ou à la recréation d’une clé.

​
Concurrency limit exceeded for user

Le compte a atteint son nombre maximal de requêtes actives. Attendez la fin des requêtes en cours, puis réduisez la concurrence. Cette erreur seule ne nécessite pas de désactiver ou recréer la clé.

​
Erreurs de longues sessions ou d’appels d’outils

​
Invalid signature in thinking block

Le contenu de raisonnement sauvegardé ne peut plus être vérifié, souvent après la reprise d’une longue session, un changement de client ou de compatibilité. Créez une nouvelle session, mettez à jour le client et évitez de poursuivre une même session sur plusieurs appareils.

​
previous_response_id is only supported on Responses WebSocket v2

Le client tente de reprendre une réponse sur un mode de connexion non pris en charge. Créez une nouvelle session, désactivez la reprise/réutilisation expérimentale de réponse ou mettez le client à jour.

​
Content block not found

Le client n’a pas reçu un fragment de contenu attendu, souvent pendant une longue conversation, un appel d’outil ou un flux interrompu. Ouvrez une nouvelle session, raccourcissez l’entrée et effectuez d’abord un test simple. Si le problème persiste, désactivez temporairement les appels d’outils non indispensables et transmettez au support le Request ID, l’heure, le modèle et l’erreur d’origine. Nous utiliserons ces éléments pour vérifier l’état du service.

​
Délai d’image ou capacité non prise en charge

Les modèles d’image doivent utiliser l’endpoint Images ; un modèle texte ne peut pas utiliser un endpoint de génération d’images. La génération est synchrone et peut être plus lente : avant de soumettre à nouveau la même tâche, vérifiez le résultat de la première requête.
  • Image generation is not enabled / model not supported : vérifiez modèle, endpoint et paramètres.
  • 504 / 524 / timeout client : conservez Request ID et heure, puis décidez si une nouvelle génération est nécessaire.
Consultez l’utilisation des modèles d’image.

​
Le compte est crédité mais la clé indique une limite insuffisante

Vérifiez le crédit du compte, la limite de la clé, son expiration et le groupe de jetons. Un message isolé peut aussi venir d’une limite de clé, d’une expiration ou d’une règle de groupe : vérifiez-les avant de recharger. En cas de persistance, fournissez le Request ID.

​
Une erreur sera-t-elle automatiquement réussie plus tard ?

Une erreur ne signifie pas nécessairement que la plateforme terminera la requête plus tard. Les appels ordinaires n’ont pas de garantie de réessai automatique au niveau plateforme. Une nouvelle requête du client crée généralement un nouveau Request ID. Décidez à partir du journal final du même Request ID et de la réception complète du contenu côté client. En cas de suspicion de double débit, fournissez les Request ID et heures concernés.

​
Informations à transmettre au support

Ne transmettez pas une clé complète, un mot de passe, des données privées ou le contenu complet d’un travail. Pour identifier une clé, fournissez au plus ses six derniers caractères.