Erreurs

​

Erreurs HTTP

Notre API suit un format d’erreur HTTP prévisible :

• 400 - invalid_request_error : Il y a eu un problème avec le format ou le contenu de votre requête. Nous pouvons également utiliser ce type d’erreur pour d’autres codes d’état 4XX non listés ci-dessous.

• 401 - authentication_error : Il y a un problème avec votre clé API.

• 403 - permission_error : Votre clé API n’a pas la permission d’utiliser la ressource spécifiée.

• 404 - not_found_error : La ressource demandée n’a pas été trouvée.

• 413 - request_too_large : La requête dépasse le nombre maximum d’octets autorisés.

• 429 - rate_limit_error : Votre compte a atteint une limite de débit.

• 500 - api_error : Une erreur inattendue s’est produite dans les systèmes internes d’Anthropic.

• 529 - overloaded_error : L’API d’Anthropic est temporairement surchargée.

  Des augmentations soudaines importantes de l’utilisation peuvent entraîner une augmentation du taux d’erreurs 529. Nous recommandons d’augmenter progressivement et de maintenir des modèles d’utilisation cohérents.

Lors de la réception d’une réponse en streaming via SSE, il est possible qu’une erreur survienne après le retour d’une réponse 200, auquel cas la gestion des erreurs ne suivrait pas ces mécanismes standard.

​

Formats d’erreur

Les erreurs sont toujours renvoyées au format JSON, avec un objet error de niveau supérieur qui inclut toujours une valeur type et message. Par exemple :

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "The requested resource could not be found."
  }
}

Conformément à notre politique de versionnement, nous pouvons étendre les valeurs au sein de ces objets, et il est possible que les valeurs type augmentent au fil du temps.

​

Identifiant de requête

Chaque réponse API inclut un en-tête request-id unique. Cet en-tête contient une valeur telle que req_018EeWyXxfu5pfWkrYcMdjWG. Lorsque vous contactez le support au sujet d’une requête spécifique, veuillez inclure cet ID pour nous aider à résoudre rapidement votre problème.

Nos SDK officiels fournissent cette valeur comme propriété sur les objets de réponse de niveau supérieur, contenant la valeur de l’en-tête x-request-id :

​

Requêtes longues

Nous ne recommandons pas de définir des valeurs max_tokens élevées sans utiliser notre API Messages en streaming ou API de lots de messages :

• Certains réseaux peuvent interrompre les connexions inactives après une période variable, ce qui peut provoquer l’échec ou l’expiration de la requête sans recevoir de réponse d’Anthropic.
• Les réseaux diffèrent en fiabilité ; notre API de lots de messages peut vous aider à gérer le risque de problèmes réseau en vous permettant d’interroger les résultats plutôt que d’exiger une connexion réseau ininterrompue.

Si vous construisez une intégration API directe, vous devez savoir que la configuration d’un keep-alive de socket TCP peut réduire l’impact des délais d’expiration de connexion inactive sur certains réseaux.

Nos SDK valideront que vos requêtes API Messages non streaming ne devraient pas dépasser un délai d’expiration de 10 minutes et configureront également une option de socket pour le keep-alive TCP.