오류 코드

이 페이지는 게이트웨이가 돌려주는 상태 코드와 그 뜻, 코드별 대처를 정리합니다.
업스트림이 4xx·5xx 를 주면 그 코드를 그대로 전달하고, 그 밖의 경우는 아래 표를 따릅니다.
두 호환 규격의 오류 본문 모양과 Anthropic 호환 error.type 의 규칙, 한도와 사용량을 확인하는 콘솔 화면도 함께 적었습니다.

상태 코드

재시도

게이트웨이는 자체 429 를 만들지 않고, 업스트림 응답을 몰래 재시도하거나 큐에 넣지도 않습니다.
기다림과 재시도는 클라이언트가 합니다.

오류 본문

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

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 로 확인한 뒤 아래 화면에서 수치를 봅니다.