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:

JSON
{
  "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.