HTTP 오류

저희 API는 예측 가능한 HTTP 오류 코드 형식을 따릅니다:

  • 400 - invalid_request_error: 요청의 형식이나 내용에 문제가 있었습니다. 아래에 나열되지 않은 다른 4XX 상태 코드에도 이 오류 유형을 사용할 수 있습니다.
  • 401 - authentication_error: API 키에 문제가 있습니다.
  • 403 - permission_error: API 키에 지정된 리소스를 사용할 수 있는 권한이 없습니다.
  • 404 - not_found_error: 요청한 리소스를 찾을 수 없습니다.
  • 413 - request_too_large: 요청이 허용된 최대 바이트 수를 초과합니다.
  • 429 - rate_limit_error: 계정이 속도 제한에 도달했습니다.
  • 500 - api_error: Anthropic 시스템 내부에서 예기치 않은 오류가 발생했습니다.
  • 529 - overloaded_error: Anthropic의 API가 일시적으로 과부하 상태입니다.

SSE를 통해 스트리밍 응답을 받을 때는 200 응답을 반환한 후에 오류가 발생할 수 있으며, 이 경우 오류 처리는 이러한 표준 메커니즘을 따르지 않습니다.

오류 형태

오류는 항상 JSON으로 반환되며, 최상위 error 객체에는 항상 typemessage 값이 포함됩니다. 예를 들면 다음과 같습니다:

JSON
{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "요청한 리소스를 찾을 수 없습니다."
  }
}

저희 버전 관리 정책에 따라 이러한 객체 내의 값을 확장할 수 있으며, type 값이 시간이 지남에 따라 증가할 수 있습니다.

요청 ID

모든 API 응답에는 고유한 request-id 헤더가 포함됩니다. 이 헤더에는 req_018EeWyXxfu5pfWkrYcMdjWG와 같은 값이 포함됩니다. 특정 요청에 대해 지원팀에 문의할 때는 이 ID를 포함하여 문제를 신속하게 해결할 수 있도록 도와주시기 바랍니다.