Erreurs HTTP

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

  • 400 - invalid_request_error : Il y avait 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 de statut 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.
  • 429 - rate_limit_error : Votre compte a atteint une limite de débit.
  • 500 - api_error : Une erreur inattendue s’est produite en interne dans les systèmes 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 se produise après le renvoi d’une réponse 200, auquel cas la gestion des erreurs ne suivrait pas ces mécanismes standard.

Formes 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 :

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 versioning, nous pouvons étendre les valeurs dans ces objets, et il est possible que les valeurs type augmentent avec le temps.