Gemini API 429 RESOURCE_EXHAUSTED — 할당량과 속도 제한을 올바르게 해결하기

RESOURCE_EXHAUSTED는 Gemini의 포괄적인 429 오류입니다. 1분 후 해제된다면 속도 제한에 걸린 것이며 백오프로 해결됩니다. 태평양 시간 기준 자정까지 지속된다면 일일 무료 등급 할당량을 모두 사용한 것입니다. 어떤 재시도 루프로도 해결할 수 없으며 결제 활성화나 다른 경로만 가능합니다.

오류

response (HTTP 429)

{
  "error": {
    "code": 429,
    "message": "Resource has been exhausted (e.g. check quota).",
    "status": "RESOURCE_EXHAUSTED"
  }
}

원인과 해결 방법 한눈에 보기

원인	해결 방법
분당 속도 제한(RPM/TPM)	지터를 포함한 백오프를 적용해 버스트를 완화합니다. 약 60초 이내에 해제됩니다.
일일 무료 등급 요청 할당량 소진	일일 재설정까지 기다리거나 결제를 활성화하고, 할당량을 늘리거나 유료 게이트웨이를 통해 라우팅합니다.
하나의 키를 공유하는 여러 워커	할당량은 워커별이 아니라 프로젝트별입니다. 속도 제한기를 중앙화하거나 프로젝트/키로 분할하세요.

분류: 분 단위 제한인가, 일일 할당량인가

60초 후 한 번 재시도하세요. 성공하면 분 단위 속도 제한입니다(백오프를 추가하고 진행). 여전히 429라면 일일 할당량입니다. Cloud Console → Quotas에서 100%가 된 정확한 카운터를 확인하세요.

분 단위 제한: 표준 백오프

모든 429와 같은 패턴입니다. 지수 백오프와 지터를 사용하고 재시도 가능한 상태만 재시도하세요. Claude 429 가이드의 스니펫을 변경 없이 재사용하면 됩니다. 제공업체와 무관합니다.

일일 할당량: 경제성을 바꾸기

무료 등급 할당량은 프로토타이핑을 위한 것입니다. 프로덕션에서는 프로젝트에서 결제를 활성화하거나, 상한이 일일 카운터가 아니라 지갑 잔액인 종량제 게이트웨이를 사용해야 합니다. 선택하기 전에 토큰당 비용을 비교하세요.

Kunavo를 통해 호출하는 경우

Kunavo에서는 Gemini 2.5 Flash/Pro를 하나의 선불 지갑으로 종량제 사용합니다. 소진할 일일 무료 등급 카운터가 없고 실패한 요청에는 요금이 부과되지 않습니다. AI Studio의 일일 할당량에 계속 걸리는 워크로드라면 토큰당 가격(Google 목록 가격보다 훨씬 낮음)이 프로젝트를 분할하는 데 드는 엔지니어링 시간보다 대개 저렴합니다.

자주 묻는 질문

Gemini 무료 등급 할당량은 언제 재설정되나요?

일일 할당량은 태평양 시간 기준 자정에 재설정됩니다. 분 단위 제한은 이동하는 60초 창에서 재설정됩니다.

백오프로 RESOURCE_EXHAUSTED를 해결할 수 있나요?

분 단위 제한에만 해당합니다. 소진된 일일 할당량은 재설정될 때까지 모든 재시도에서 429를 반환합니다. 이 경우(60초 대기 후에도 429가 지속됨)를 감지하고 재시도로 낭비하지 마세요.