Erros HTTP

Nossa API segue um formato previsível de códigos 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 streaming via SSE, é possível que ocorra um erro após retornar uma resposta 200, caso em que o tratamento de erros 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 um valor type e message. Por exemplo:

JSON
{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "O recurso solicitado não pôde ser encontrado."
  }
}

De acordo com nossa política de versionamento, podemos expandir os valores dentro desses objetos, e é possível que os valores type cresçam ao longo do tempo.

ID da solicitação

Cada resposta da API inclui um cabeçalho request-id exclusivo. 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 rapidamente seu problema.