k
korAI
트러블슈팅 목록
Troubleshoot

OpenAI 429 Rate Limit 에러 해결

OpenAI API가 429 rate limit 에러를 반환할 때 원인 5가지와 해결법. Tier 시스템, 지수 백오프, 배치 분산, 모델 다운그레이드까지.

증상

API 호출이 `429 Too Many Requests` 또는 `RateLimitError`로 실패.

원인

분당 요청 수(RPM) 또는 분당 토큰(TPM) 한도 초과. Tier에 따라 한도가 다름.

해결 단계

  1. 1

    현재 Tier 확인

    https://platform.openai.com/settings/organization/limits 에서 본인 계정 Tier와 모델별 한도 확인.

  2. 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. 3

    Tier 업그레이드

    Tier 1 → Tier 2는 누적 결제 $50 + 7일 경과로 자동. 그 이상은 결제 추가 필요.

  4. 4

    Batch API 활용

    지연 OK인 작업은 Batch API로 보내면 한도 다른 풀에서 처리되고 50% 할인까지.

  5. 5

    모델 다운그레이드

    GPT-5에서 GPT-5 mini나 GPT-4o-mini로 전환하면 단일 요청당 토큰 사용량 감소 → 한도 여유 확보.