Kuota Gemini API terlampaui (429 RESOURCE_EXHAUSTED)
Gemini API mengembalikan 429 RESOURCE_EXHAUSTED saat Anda melampaui batas laju atau kuota harian. Pada paket gratis, batasnya kecil. Halaman ini menjelaskan setiap bentuk error, batas gratis saat ini, dan perbaikan yang berhasil.
Kode, nama model, dan label katalog langsung ditampilkan dalam bahasa Inggris.
Tampilan error
Contoh error paket gratis yang umum, seperti yang dipublikasikan di forum pengembang Google, memiliki bagian-bagian berikut:
Contoh 429 dari paket gratis
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.quotaMetricmenunjukkan apa yang habis.generate_content_free_tier_requestsmenghitung permintaan pada paket gratis.quotaIdmenunjukkan jendela waktunya.PerDayadalah kuota harian. IDPerMinuteadalah batas per menit.limitadalah kuota Anda untuk model itu pada jendela tersebut.Please retry inmemberikan waktu tunggu yang disarankan Google.
Tiga kode 429 dan satu 403
Halaman error API Google mencantumkan tiga kode error dengan HTTP 429, dan satu 403 yang terkait:
| Kode | HTTP | Arti | Perbaikan |
|---|---|---|---|
rate_limit_exceeded | 429 | Batas permintaan atau token per menit atau per detik tercapai | Coba lagi dengan backoff eksponensial |
quota_exceeded | 429 | Kuota harian sudah habis | Tunggu reset, atau minta peningkatan |
too_many_requests | 429 | Terlalu banyak permintaan dalam jendela waktu yang singkat | Coba lagi dengan backoff eksponensial |
permission_denied | 403 | Proyek dibatasi, atau paket gratis tidak tersedia untuknya | Tautkan akun penagihan dan gunakan paket berbayar |
Batas per menit berakhir dalam waktu kurang dari satu menit. Kuota harian hanya berakhir saat reset. Google mereset permintaan per hari pada tengah malam waktu Pasifik. Mencoba ulang error kuota harian sebelum reset hanya membuang permintaan.
Batas paket gratis saat ini
Google menerapkan batas pada setiap proyek Google Cloud, bukan pada setiap kunci. Batasnya berbeda untuk setiap model. Google menampilkan batas aktif Anda di AI Studio. Tabel menampilkan batas paket gratis Gemini dan Gemma dalam katalog FreeLLMAPI.
| Model | Gratis di | Konteks | Batas gratis (penawaran terbaik) | Alat | Pemrosesan gambar |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ya | Ya |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.8 Live | Google AI Studio | - | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Tidak | Tidak |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Tidak | Tidak |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Tidak | Ya |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
Menampilkan 12 dari 21 model gratis yang cocok. Lihat semua model.
Data langsung dari katalog FreeLLMAPI (versi 2026.11.19, diperiksa 2026-11-19). Batas gratis sering berubah. Katalog diperiksa setiap hari.
Sebagian besar model Flash mengizinkan sekitar 20 permintaan per hari pada paket gratis. Model Gemma mengizinkan jauh lebih banyak permintaan per hari, tetapi jendela konteksnya lebih kecil. Google menyatakan bahwa batas yang tertulis tidak dijamin dan kapasitas aktual dapat berbeda.
Perbaikan yang berhasil
- Baca
quotaId. Jika berisiPerDay, berhenti dan tunggu reset pada tengah malam waktu Pasifik. - Untuk batas per menit, coba lagi dengan backoff eksponensial dan jitter. Tetapkan jumlah percobaan ulang maksimum.
- Pindahkan tugas sederhana ke model dengan batas harian lebih tinggi, misalnya model Gemma atau Flash-Lite.
- Kirim lebih sedikit token. Prompt besar cepat mencapai batas token per menit.
- Jangan gunakan
max_tokensyang sangat kecil. Gemini Flash dapat memakai token penalaran tersembunyi di dalam batas keluaran.
| Yang Anda coba | Apakah membantu? | Alasan |
|---|---|---|
| Buat kunci API baru di proyek yang sama | Tidak | Batas berlaku untuk proyek. Google menyatakan kunci baru tidak menyelesaikan error ini. |
| Tingkatkan proyek ke paket berbayar | Memberi kuota berbayar | Google menyatakan bahwa paket berbayar tidak memberi kuota paket gratis. Penggunaan berbayar ditagih. |
Tunggu waktu retry in | Ya, untuk batas per menit | Jendela menit berganti |
| Ganti ke model lain | Ya | Setiap model memiliki kuotanya sendiri |
Periksa kuota Anda sebelum mengirim
Anda dapat melihat masalahnya sebelum error muncul. Di AI Studio, buka halaman batas laju dari dokumentasi Gemini API. Halaman itu menampilkan batas aktif proyek Anda untuk setiap model. Halaman Projects menampilkan tingkat Anda.
Jika Anda memakai FreeLLMAPI, tanyakan kepada gateway model mana yang siap sekarang. Model dengan status exhausted memiliki kunci yang semuanya berada dalam masa tunggu. Status itu hilang dengan sendirinya saat masa tunggu berakhir.
Daftar model yang dapat menjawab sekarang
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Rencanakan pemakaian harian Anda dengan angka sederhana. Dengan 20 permintaan per hari, satu model Flash memberi Anda sekitar satu permintaan setiap 72 menit selama sehari penuh. Agen koding dapat memakai 20 permintaan untuk satu tugas. Gunakan model Flash hanya untuk tugas yang sulit, dan kirim tugas sederhana ke model dengan batas harian lebih besar.
Failover ke penyedia gratis lain
Dengan sekitar 20 permintaan Flash per hari, satu kunci Gemini tidak cukup untuk pekerjaan agen. FreeLLMAPI menempatkan Gemini di balik satu endpoint bersama penyedia gratis lain. Saat Gemini mengirim 429, router mengirim permintaan ke model berikutnya dalam rantai Anda.
- Router menghitung RPM, RPD, TPM, dan TPD untuk setiap model dan kunci. Router berhenti sebelum mencapai batas yang diketahui.
- 429 singkat menempatkan kunci dalam masa tunggu 90 detik. Kuota harian penuh memakai masa tunggu yang lebih lama: 2 menit, 10 menit, 1 jam, lalu 24 jam.
- Jika Google memberi waktu coba lagi yang lebih lama, router memakai nilai dari Google.
- Header
X-Fallback-Trailmencantumkan setiap lompatan yang gagal, misalnyagoogle/gemini-2.5-flash key1=rate_limited.
Kirim lalu lintas Gemini melalui gateway
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 juga dapat memakai permukaan native /v1beta dari gateway. Gateway tidak menambahkan kuota Gemini. Gateway memakai penyedia lain saat Gemini mencapai batasnya.
Keunikan Gemini yang diketahui
| Penyedia | Masalah yang diketahui | Yang harus dilakukan |
|---|---|---|
| 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. |
Data langsung dari katalog FreeLLMAPI (versi 2026.11.19, diperiksa 2026-11-19). Batas gratis sering berubah. Katalog diperiksa setiap hari.
Pertanyaan yang sering diajukan
Apa arti 429 RESOURCE_EXHAUSTED di Gemini API?
Artinya proyek Anda melampaui batas laju atau kuota. quotaId di badan error memberi tahu apakah ini batas per menit atau kuota harian.
Kapan kuota paket gratis Gemini direset?
Permintaan per hari direset pada tengah malam waktu Pasifik. Batas per menit direset dalam satu menit.
Mengapa kunci Gemini API baru tidak memperbaiki error kuota?
Google menerapkan batas pada proyek Google Cloud, bukan pada kunci. Setiap kunci dalam proyek yang sama berbagi kuota yang sama.
Apa arti limit: 0 dalam error kuota Gemini?
Artinya proyek Anda tidak memiliki kuota gratis untuk model itu pada jendela tersebut. Sebagian proyek tidak memenuhi syarat untuk paket gratis. Periksa batas Anda di AI Studio atau coba model lain.
Bagaimana cara menghindari error 429 Gemini di agen koding?
Gunakan beberapa penyedia gratis di balik satu gateway. Saat Gemini mencapai batasnya, gateway mengirim permintaan ke penyedia lain, sehingga agen tetap berjalan.
Panduan terkait
- Batas rate limit API LLM gratis
- free gemini api
- Gemini CLI dengan endpoint kustom dan model gratis
- Batas laju Groq tercapai (429)
- Batas rate limit API NVIDIA NIM
Sumber
- Google AI Studio: Rate limits (diperiksa 20 November 2026)
- Google AI Studio: API errors (diperiksa 20 November 2026)
- Google AI Studio: Troubleshooting (diperiksa 20 November 2026)
- Google developer forum: free tier quota error example (diperiksa 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (diperiksa 20 November 2026)
- FreeLLMAPI docs: Response headers (diperiksa 20 November 2026)