HTTP ошибки

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

  • 400 - invalid_request_error: Возникла проблема с форматом или содержанием вашего запроса. Мы также можем использовать этот тип ошибки для других кодов состояния 4XX, не перечисленных ниже.
  • 401 - authentication_error: Возникла проблема с вашим API-ключом.
  • 403 - permission_error: У вашего API-ключа нет разрешения на использование указанного ресурса.
  • 404 - not_found_error: Запрошенный ресурс не найден.
  • 413 - request_too_large: Запрос превышает максимально допустимое количество байтов.
  • 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": "The requested resource could not be found."
  }
}

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

Идентификатор запроса

Каждый ответ API включает уникальный заголовок request-id. Этот заголовок содержит значение, например req_018EeWyXxfu5pfWkrYcMdjWG. При обращении в службу поддержки по поводу конкретного запроса, пожалуйста, укажите этот ID, чтобы помочь нам быстро решить вашу проблему.