Erros
Erros HTTP
Nossa API segue um formato previsível de código de erro HTTP:
- 400 -
invalid_request_error
: Houve um problema com o formato ou conteúdo da sua solicitação. Também podemos usar este tipo de erro para outros códigos de status 4XX não listados abaixo. - 401 -
authentication_error
: Há um problema com sua chave de API. - 403 -
permission_error
: Sua chave de API não tem permissão para usar o recurso especificado. - 404 -
not_found_error
: O recurso solicitado não foi encontrado. - 413 -
request_too_large
: A solicitação excede o número máximo permitido de bytes. - 429 -
rate_limit_error
: Sua conta atingiu um limite de taxa. - 500 -
api_error
: Ocorreu um erro inesperado interno nos sistemas da Anthropic. - 529 -
overloaded_error
: A API da Anthropic está temporariamente sobrecarregada.
Ao receber uma resposta de streaming via SSE, é possível que ocorra um erro após retornar uma resposta 200, caso em que o tratamento de erro não seguiria esses mecanismos padrão.
Formatos de Erro
Os erros são sempre retornados como JSON, com um objeto error
de nível superior que sempre inclui valores type
e message
. Por exemplo:
De acordo com nossa política de versionamento, podemos expandir os valores dentro desses objetos, e é possível que os valores type
aumentem ao longo do tempo.
ID da solicitação
Cada resposta da API inclui um cabeçalho único request-id
. Este cabeçalho contém um valor como req_018EeWyXxfu5pfWkrYcMdjWG
. Ao entrar em contato com o suporte sobre uma solicitação específica, inclua este ID para nos ajudar a resolver seu problema rapidamente.