Erreurs HTTP

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

  • 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 taux.
  • 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.

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.

Formes d’erreurs

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 :

JSON
{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "La ressource demandée n'a pas pu être trouvée."
  }
}

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 identifiant pour nous aider à résoudre rapidement votre problème.