오류 코드

게이트웨이는 업스트림이 4xx·5xx를 반환하면 그 코드를 그대로 전달하고, 그 밖의 경우에는 아래 표의 규칙을 따릅니다.
400·401·403·404·413은 요청이나 설정을 고쳐야 하는 코드이고, 409·429·5xx는 클라이언트가 기다렸다가 같은 요청을 다시 보내는 코드입니다.

오류 본문의 형식은 규격마다 다르며, Anthropic 호환 경로의 error.type은 상태 코드로 정해집니다.
403의 사유는 error.message로 구분하고, 한도와 사용량 수치는 콘솔 화면에서 확인합니다.

상태 코드

402는 반환하지 않습니다. 크레딧 부족과 사용 한도 초과는 모두 403으로 반환합니다.

재시도와 문의

게이트웨이는 자체 429를 만들지 않으며, 업스트림 응답을 대신 재시도하거나 큐에 넣지 않습니다. 대기와 재시도는 클라이언트가 수행합니다.

문의할 때는 도움말과 문의로 X-Request-Id와 함께 알려 주세요. X-Request-Id를 보내지 않았다면 서버가 발급한 값이 Anthropic 호환 응답의 request-id 헤더에 있습니다.

오류 본문

오류 본문의 형식은 규격마다 다릅니다. 업스트림 오류는 메시지만 남기고 정리해 전달하며, 스택이나 내부 필드는 전달하지 않습니다.

OpenAI 호환 경로의 오류 본문입니다.

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}

Anthropic 호환 경로의 오류 본문입니다. error.type은 상태 코드에 따라 아래 표와 같이 정해집니다.

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}

한도와 사용량 확인

한도 수치는 워크스페이스마다 다릅니다. 403의 사유를 error.message로 확인한 뒤, 다음 화면에서 수치를 확인하세요.