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:

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "The requested resource could not be found."
  }
}

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.