Использование API
Ошибки
Ошибки 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
будут расти со временем.