Gemini API 할당량 초과 (429 RESOURCE_EXHAUSTED)
Gemini API는 요청 속도 한도 또는 일일 할당량을 넘으면 429 RESOURCE_EXHAUSTED를 반환합니다. 무료 등급의 한도는 작습니다. 이 페이지는 이 오류의 각 형태, 현재 무료 한도, 효과가 있는 해결 방법을 설명합니다.
코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.
오류의 모습
Google 개발자 포럼에 게시된 전형적인 무료 등급 오류는 다음 부분으로 구성됩니다:
무료 등급의 429 예시
429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.
Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 50
quotaId: GenerateRequestsPerDayPerProjectPerModel-FreeTier
Please retry in 11.615098148s.quotaMetric은 무엇이 소진되었는지 알려 줍니다.generate_content_free_tier_requests는 무료 등급의 요청 수를 셉니다.quotaId는 시간 구간을 알려 줍니다.PerDay는 일일 할당량입니다.PerMinuteID는 분당 한도입니다.limit은 그 구간에서 해당 모델에 대한 할당량입니다.Please retry in는 Google이 제안하는 대기 시간을 알려 줍니다.
429 코드 세 개와 403 하나
Google API 오류 페이지는 HTTP 429인 오류 코드 세 개와 관련된 403을 나열합니다:
| 코드 | HTTP | 의미 | 해결 방법 |
|---|---|---|---|
rate_limit_exceeded | 429 | 분당 또는 초당 요청 또는 토큰 한도에 도달함 | 지수 백오프로 다시 시도하십시오 |
quota_exceeded | 429 | 일일 할당량을 모두 사용함 | 초기화될 때까지 기다리거나, 증가를 요청하십시오 |
too_many_requests | 429 | 짧은 시간 안에 요청이 너무 많음 | 지수 백오프로 다시 시도하십시오 |
permission_denied | 403 | 프로젝트가 제한되었거나, 해당 프로젝트에서 무료 등급을 사용할 수 없음 | 결제 계정을 연결하고 유료 등급을 사용하십시오 |
분당 한도는 1분 안에 해제됩니다. 일일 할당량은 초기화 시점에만 해제됩니다. Google은 일일 요청을 태평양 표준시 자정에 초기화합니다. 초기화 전에 일일 할당량 오류를 다시 시도하면 요청이 낭비됩니다.
오늘의 무료 등급 한도
Google은 키 단위가 아니라 Google Cloud 프로젝트 단위로 한도를 적용합니다. 한도는 모델마다 다릅니다. Google은 AI Studio에서 활성 한도를 보여 줍니다. 이 표는 FreeLLMAPI 카탈로그의 무료 Gemini 및 Gemma 한도를 보여 줍니다.
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 예 | 예 |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.8 Live | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | 아니요 | 아니요 |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | 아니요 | 아니요 |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 아니요 | 예 |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
일치하는 무료 모델 21개 중 12개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
대부분의 Flash 모델은 무료 등급에서 하루 약 20 요청을 허용합니다. Gemma 모델은 하루에 훨씬 많은 요청을 허용하지만 컨텍스트 창이 더 작습니다. Google은 명시된 한도가 보장되지 않으며 실제 용량은 달라질 수 있다고 말합니다.
효과가 있는 해결 방법
quotaId를 읽으십시오.PerDay가 포함되어 있으면 중지하고 태평양 표준시 자정의 초기화를 기다리십시오.- 분당 한도라면 지터를 포함한 지수 백오프로 다시 시도하십시오. 최대 재시도 횟수를 설정하십시오.
- 간단한 작업은 일일 상한이 더 높은 모델로 옮기십시오. 예: Gemma 또는 Flash-Lite 모델.
- 보내는 토큰을 줄이십시오. 큰 프롬프트는 분당 토큰 한도에 빨리 도달합니다.
max_tokens를 아주 작게 설정하지 마십시오. Gemini Flash는 출력 상한 안에서 숨겨진 생각 토큰을 사용할 수 있습니다.
| 시도한 방법 | 도움이 되나요? | 이유 |
|---|---|---|
| 같은 프로젝트에서 새 API 키 만들기 | 아니요 | 한도는 프로젝트에 적용됩니다. Google은 새 키로는 오류가 해결되지 않는다고 말합니다. |
| 프로젝트를 유료 등급으로 업그레이드하기 | 유료 할당량을 제공함 | Google은 유료 등급이 무료 등급 할당량을 주지 않는다고 말합니다. 유료 사용은 과금됩니다. |
retry in 시간까지 기다리기 | 예, 분당 한도의 경우 | 분당 구간이 넘어갑니다 |
| 다른 모델로 바꾸기 | 예 | 모델마다 자체 할당량이 있습니다 |
보내기 전에 할당량 확인하기
오류가 나기 전에 문제를 볼 수 있습니다. AI Studio에서 Gemini API 문서의 요청 한도 페이지를 여십시오. 모델별로 프로젝트의 활성 한도를 보여 줍니다. Projects 페이지에서 등급을 확인할 수 있습니다.
FreeLLMAPI를 사용한다면 게이트웨이에 지금 준비된 모델을 물어보십시오. 상태가 exhausted인 모델은 모든 키가 쿨다운 상태입니다. 쿨다운이 끝나면 이 상태는 스스로 해제됩니다.
지금 응답할 수 있는 모델 나열
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"간단한 숫자로 일일 사용량을 계획하십시오. 하루 20 요청이면 Flash 모델 하나는 하루 종일 약 72분마다 한 요청을 제공합니다. 코딩 에이전트는 작업 하나에 요청 20건을 쓸 수 있습니다. Flash 모델은 어려운 작업에만 사용하고, 간단한 작업은 일일 상한이 더 큰 모델로 보내십시오.
다른 무료 제공업체로 자동 전환
하루 약 20건의 Flash 요청으로는 에이전트 작업에 Gemini 키 하나로 부족합니다. FreeLLMAPI는 Gemini를 다른 무료 제공업체와 함께 하나의 엔드포인트 뒤에 둡니다. Gemini가 429를 보내면 라우터는 요청을 체인의 다음 모델로 보냅니다.
- 라우터는 각 모델과 키에 대해 RPM, RPD, TPM, TPD를 셉니다. 알려진 한도에 도달하기 전에 멈춥니다.
- 짧은 429는 해당 키를 90초 쿨다운에 둡니다. 일일 할당량을 모두 쓰면 더 긴 쿨다운을 사용합니다. 2분, 10분, 1시간, 그다음 24시간입니다.
- Google이 더 긴 재시도 시간을 제공하면 라우터는 Google의 값을 사용합니다.
X-Fallback-Trail헤더는 실패한 각 단계를 나열합니다. 예:google/gemini-2.5-flash key1=rate_limited.
Gemini 트래픽을 게이트웨이로 보내기
curl -fsSL https://freellmapi.co/install.sh | bash
curl -i http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'Gemini CLI도 게이트웨이의 네이티브 /v1beta 인터페이스를 사용할 수 있습니다. 게이트웨이는 Gemini 할당량을 추가하지 않습니다. Gemini가 한도에 도달하면 다른 제공업체를 사용합니다.
알려진 Gemini 특이 사항
| 제공업체 | 알려진 문제 | 해결 방법 |
|---|---|---|
| Google AI Studio | Thinking tokens use output cap | Gemini Flash can spend hidden thinking tokens inside maxOutputTokens. Avoid tiny max_tokens values or set thinkingBudget to 0 when provider support is available. |
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
자주 묻는 질문
Gemini API에서 429 RESOURCE_EXHAUSTED는 무엇을 뜻합니까?
프로젝트가 요청 속도 한도 또는 할당량을 넘었다는 뜻입니다. 오류 본문의 quotaId는 분당 한도인지 일일 할당량인지 알려 줍니다.
Gemini 무료 등급 할당량은 언제 초기화됩니까?
일일 요청은 태평양 표준시 자정에 초기화됩니다. 분당 한도는 1분 이내에 초기화됩니다.
새 Gemini API 키로 할당량 오류가 해결되지 않는 이유는 무엇입니까?
Google은 키가 아니라 Google Cloud 프로젝트에 한도를 적용합니다. 같은 프로젝트의 모든 키가 같은 할당량을 공유합니다.
Gemini 할당량 오류의 limit: 0은 무엇을 뜻합니까?
해당 구간에서 프로젝트에 그 모델의 무료 할당량이 없다는 뜻입니다. 일부 프로젝트는 무료 등급 대상이 아닙니다. AI Studio에서 한도를 확인하거나 다른 모델을 시도하십시오.
코딩 에이전트에서 Gemini 429 오류를 피하려면 어떻게 합니까?
게이트웨이 하나 뒤에 무료 제공업체 여러 곳을 두십시오. Gemini가 한도에 도달하면 게이트웨이가 요청을 다른 제공업체로 보내므로 에이전트는 계속 작동합니다.
관련 가이드
- 무료 LLM API 속도 제한
- free gemini api
- 사용자 지정 엔드포인트와 무료 모델을 쓰는 Gemini CLI
- Groq 요율 제한 도달 (429)
- NVIDIA NIM API 속도 제한
출처
- Google AI Studio: Rate limits (20 November 2026 확인)
- Google AI Studio: API errors (20 November 2026 확인)
- Google AI Studio: Troubleshooting (20 November 2026 확인)
- Google developer forum: free tier quota error example (20 November 2026 확인)
- FreeLLMAPI docs: Quota and cooldown engine (20 November 2026 확인)
- FreeLLMAPI docs: Response headers (20 November 2026 확인)