Kuota Gemini API melebihi (429 RESOURCE_EXHAUSTED)
API Gemini memulangkan 429 RESOURCE_EXHAUSTED apabila anda melebihi had kadar atau kuota harian. Pada peringkat percuma, had adalah kecil. Halaman ini menerangkan setiap bentuk ralat, had percuma semasa dan pembetulan yang berfungsi.
Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.
Rupa ralat
Ralat peringkat percuma yang biasa, seperti yang dipaparkan di forum pembangun Google, mempunyai bahagian berikut:
Contoh 429 dari peringkat percuma
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.quotaMetricmemberitahu anda apa yang habis.generate_content_free_tier_requestsmengira permintaan pada peringkat percuma.quotaIdmemberitahu anda tetingkap masa.PerDayialah kuota harian. IDPerMinuteialah had seminit.limitialah kuota anda untuk model itu dalam tetingkap tersebut.Please retry inmemberikan masa tunggu yang dicadangkan oleh Google.
Tiga kod 429 dan satu 403
Halaman ralat API Google menyenaraikan tiga kod ralat dengan HTTP 429, dan satu 403 yang berkaitan:
| Kod | HTTP | Maksud | Pembetulan |
|---|---|---|---|
rate_limit_exceeded | 429 | Had permintaan atau token setiap minit atau setiap saat dicapai | Cuba semula dengan backoff eksponen |
quota_exceeded | 429 | Kuota harian habis | Tunggu tetapan semula, atau minta peningkatan |
too_many_requests | 429 | Terlalu banyak permintaan dalam tetingkap yang singkat | Cuba semula dengan backoff eksponen |
permission_denied | 403 | Projek disekat, atau peringkat percuma tidak tersedia untuknya | Pautkan akaun bil dan gunakan peringkat berbayar |
Had seminit hilang dalam masa kurang daripada satu minit. Kuota harian hanya hilang pada tetapan semula. Google menetapkan semula permintaan setiap hari pada tengah malam waktu Pacific. Mencuba semula ralat kuota harian sebelum tetapan semula membazirkan permintaan.
Had peringkat percuma hari ini
Google mengenakan had pada setiap projek Google Cloud, bukan pada setiap kunci. Had berbeza untuk setiap model. Google menunjukkan had aktif anda dalam AI Studio. Jadual menunjukkan had percuma Gemini dan Gemma dalam katalog FreeLLMAPI.
| Model | Percuma pada | Konteks | Had percuma (tawaran terbaik) | Alat | Penglihatan |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ya | Ya |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.8 Live | Google AI Studio | - | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~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/minit 20 permintaan/hari 250,000 token/minit ~3M | Tidak | Ya |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
Memaparkan 12 daripada 21 model percuma yang sepadan. Lihat semua model.
Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.
Kebanyakan model Flash membenarkan kira-kira 20 permintaan sehari pada peringkat percuma. Model Gemma membenarkan lebih banyak permintaan sehari, tetapi tetingkap konteksnya lebih kecil. Google menyatakan bahawa had yang dinyatakan tidak dijamin dan kapasiti sebenar mungkin berbeza.
Pembetulan yang berfungsi
- Baca
quotaId. Jika ia mengandungiPerDay, berhenti dan tunggu tetapan semula pada tengah malam waktu Pacific. - Untuk had seminit, cuba semula dengan backoff eksponen dan jitter. Tetapkan bilangan percubaan maksimum.
- Pindahkan tugas mudah ke model dengan had harian yang lebih tinggi, contohnya model Gemma atau Flash-Lite.
- Hantar lebih sedikit token. Prompt besar cepat mencapai had token seminit.
- Jangan gunakan
max_tokensyang sangat kecil. Gemini Flash boleh menggunakan token penaakulan tersembunyi dalam had output.
| Apa yang anda cuba | Adakah ia membantu? | Mengapa |
|---|---|---|
| Cipta kunci API baharu dalam projek yang sama | Tidak | Had dikenakan pada projek. Google menyatakan kunci baharu tidak menyelesaikan ralat. |
| Naik taraf projek ke peringkat berbayar | Memberikan kuota berbayar | Google menyatakan peringkat berbayar tidak memberikan kuota peringkat percuma. Penggunaan berbayar dicaj. |
Tunggu masa retry in | Ya, untuk had seminit | Tetingkap seminit ditetapkan semula |
| Tukar kepada model yang berbeza | Ya | Setiap model mempunyai kuotanya sendiri |
Semak kuota anda sebelum menghantar
Anda boleh melihat masalah sebelum ralat berlaku. Dalam AI Studio, buka halaman had kadar dari dokumentasi API Gemini. Ia menunjukkan had aktif projek anda bagi setiap model. Halaman Projects menunjukkan tahap anda.
Jika anda menggunakan FreeLLMAPI, tanya get laluan model mana yang sedia sekarang. Model dengan status exhausted mempunyai kunci yang semuanya berada dalam tempoh rehat. Status itu hilang dengan sendirinya apabila tempoh rehat tamat.
Senaraikan model yang boleh menjawab sekarang
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Rancang penggunaan harian anda dengan nombor yang mudah. Pada 20 permintaan sehari, satu model Flash memberikan anda kira-kira satu permintaan setiap 72 minit sepanjang hari. Satu ejen pengekodan boleh menggunakan 20 permintaan untuk satu tugas. Letakkan model Flash hanya pada tugas yang sukar, dan hantar tugas mudah ke model dengan had harian yang lebih besar.
Beralih ke pembekal percuma lain
Dengan kira-kira 20 permintaan Flash sehari, satu kunci Gemini tidak mencukupi untuk kerja ejen. FreeLLMAPI meletakkan Gemini di belakang satu titik akhir bersama pembekal percuma lain. Apabila Gemini menghantar 429, penghala menghantar permintaan ke model seterusnya dalam rantai anda.
- Penghala mengira RPM, RPD, TPM dan TPD bagi setiap model dan kunci. Ia berhenti sebelum mencapai had yang diketahui.
- 429 yang singkat meletakkan kunci dalam tempoh rehat 90 saat. Kuota harian penuh menggunakan tempoh rehat yang lebih panjang: 2 minit, 10 minit, 1 jam, kemudian 24 jam.
- Jika Google memberikan masa cuba semula yang lebih panjang, penghala menggunakan nilai Google.
- Header
X-Fallback-Trailmenyenaraikan setiap hop yang gagal, contohnyagoogle/gemini-2.5-flash key1=rate_limited.
Hantar trafik Gemini melalui get laluan
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 boleh menggunakan permukaan asal /v1beta get laluan. Get laluan tidak menambah kuota Gemini. Ia menggunakan pembekal lain apabila Gemini mencapai had.
Keanehan Gemini yang diketahui
| Pembekal | Isu diketahui | Apa yang perlu 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 daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.
Soalan lazim
Apa maksud 429 RESOURCE_EXHAUSTED dalam API Gemini?
Ia bermaksud projek anda melebihi had kadar atau kuota. quotaId dalam badan ralat memberitahu anda sama ada ia had seminit atau kuota harian.
Bilakah kuota peringkat percuma Gemini ditetapkan semula?
Permintaan sehari ditetapkan semula pada tengah malam waktu Pacific. Had seminit ditetapkan semula dalam masa satu minit.
Mengapa kunci API Gemini baharu tidak membetulkan ralat kuota?
Google mengenakan had pada projek Google Cloud, bukan pada kunci. Setiap kunci dalam projek yang sama berkongsi kuota yang sama.
Apa maksud limit: 0 dalam ralat kuota Gemini?
Ia bermaksud projek anda tidak mempunyai kuota percuma untuk model itu dalam tetingkap tersebut. Sesetengah projek tidak layak untuk peringkat percuma. Semak had anda dalam AI Studio atau cuba model yang berbeza.
Bagaimana saya mengelakkan ralat 429 Gemini dalam ejen pengekodan?
Gunakan beberapa pembekal percuma di belakang satu get laluan. Apabila Gemini mencapai had, get laluan menghantar permintaan ke pembekal lain, supaya ejen terus berjalan.
Panduan berkaitan
- Had kadar Free LLM API
- free gemini api
- Gemini CLI dengan titik akhir tersuai dan model percuma
- Had kadar Groq dicapai (429)
- Had kadar NVIDIA NIM API
Sumber
- Google AI Studio: Rate limits (disemak 20 November 2026)
- Google AI Studio: API errors (disemak 20 November 2026)
- Google AI Studio: Troubleshooting (disemak 20 November 2026)
- Google developer forum: free tier quota error example (disemak 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (disemak 20 November 2026)
- FreeLLMAPI docs: Response headers (disemak 20 November 2026)