Troubleshoot
OpenAI 429 Rate Limit 에러 해결
OpenAI API가 429 rate limit 에러를 반환할 때 원인 5가지와 해결법. Tier 시스템, 지수 백오프, 배치 분산, 모델 다운그레이드까지.
증상
API 호출이 `429 Too Many Requests` 또는 `RateLimitError`로 실패.
원인
분당 요청 수(RPM) 또는 분당 토큰(TPM) 한도 초과. Tier에 따라 한도가 다름.
해결 단계
- 1
현재 Tier 확인
https://platform.openai.com/settings/organization/limits 에서 본인 계정 Tier와 모델별 한도 확인.
- 2
지수 백오프 구현
429 시 즉시 재시도 X. 1초→2초→4초→8초로 간격 증가 후 재시도.
for (let i = 0; i < 5; i++) { try { return await call() } catch (e) { if (e.status === 429) { await new Promise(r => setTimeout(r, 1000 * 2 ** i)) continue } throw e } } - 3
Tier 업그레이드
Tier 1 → Tier 2는 누적 결제 $50 + 7일 경과로 자동. 그 이상은 결제 추가 필요.
- 4
Batch API 활용
지연 OK인 작업은 Batch API로 보내면 한도 다른 풀에서 처리되고 50% 할인까지.
- 5
모델 다운그레이드
GPT-5에서 GPT-5 mini나 GPT-4o-mini로 전환하면 단일 요청당 토큰 사용량 감소 → 한도 여유 확보.