​
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, чтобы помочь нам быстро решить вашу проблему.

Наши официальные SDK предоставляют это значение как свойство объектов ответа верхнего уровня, содержащее значение заголовка x-request-id:

Was this page helpful?

ВерсииОграничения