오류 · openai-api
OpenAI API 429: 속도 제한과 할당량 문제 구분
공식 오류 코드와 응답 헤더로 429를 진단하고 Codex 요금제 한도와 혼동하지 마세요.
마지막 검증:
핵심 답변
HTTP 429만으로 ChatGPT나 Codex 할당량이 다했다고 판단할 수 없습니다. API에서는 error.code와 응답 헤더를 확인하세요. slow_down은 요청 증가가 빠르다는 뜻이므로 Retry-After를 따르고 속도를 줄여야 합니다.
적용 범위
API Key로 OpenAI API를 호출하는 애플리케이션용이며 ChatGPT 요금제의 Codex 사용량은 해당하지 않습니다.
할 일
- 1요청이 ChatGPT 요금제가 아니라 API Key를 사용하는지 확인하세요.
- 2HTTP 상태, error.code, x-request-id는 기록하되 API Key는 기록하지 마세요.
- 3slow_down이면 Retry-After 이상 기다리고 무작위 백오프를 추가하세요.
- 4x-ratelimit-remaining-* 및 x-ratelimit-reset-*로 요청과 토큰 한도를 구분하세요.
- 5결제나 할당량처럼 조치가 필요한 오류를 무한 재시도하지 마세요.
흔한 오해
- 모든 429는 같은 고정 시간에 풀린다.
- 즉시 반복하면 더 빨리 복구된다. 실패한 요청도 한도에 포함될 수 있습니다.
다음 단계
민감 정보를 제거한 오류 코드와 헤더를 보존한 뒤 오류에 맞게 대기, 감속, 결제 확인을 선택하세요.
최신 출처 신호 확인 →