Ошибки HTTP

Наш API следует предсказуемому формату кодов ошибок HTTP:

  • 400 - invalid_request_error: Возникла проблема с форматом или содержанием вашего запроса. Мы также можем использовать этот тип ошибки для других кодов состояния 4XX, не перечисленных ниже.
  • 401 - authentication_error: Возникла проблема с вашим ключом API.
  • 403 - permission_error: Ваш ключ API не имеет разрешения на использование указанного ресурса.
  • 404 - not_found_error: Запрошенный ресурс не найден.
  • 429 - rate_limit_error: Ваша учетная запись достигла ограничения скорости.
  • 500 - api_error: Произошла непредвиденная ошибка внутри систем Anthropic.
  • 529 - overloaded_error: API Anthropic временно перегружен.

При получении потокового ответа через SSE возможно возникновение ошибки после возврата ответа 200, и в этом случае обработка ошибок не будет следовать этим стандартным механизмам.

Формы ошибок

Ошибки всегда возвращаются в формате JSON с объектом error верхнего уровня, который всегда включает значения type и message. Например:

JSON
{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "Запрошенный ресурс не найден."
  }
}

В соответствии с нашей политикой версионирования, мы можем расширять значения внутри этих объектов, и возможно, что значения type будут расти со временем.