Laman utama / Panduan / Kuota Gemini API melebihi (429 RESOURCE_EXHAUSTED)

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.
  • quotaMetric memberitahu anda apa yang habis. generate_content_free_tier_requests mengira permintaan pada peringkat percuma.
  • quotaId memberitahu anda tetingkap masa. PerDay ialah kuota harian. ID PerMinute ialah had seminit.
  • limit ialah kuota anda untuk model itu dalam tetingkap tersebut.
  • Please retry in memberikan 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:

Dari halaman ralat API Gemini
KodHTTPMaksudPembetulan
rate_limit_exceeded429Had permintaan atau token setiap minit atau setiap saat dicapaiCuba semula dengan backoff eksponen
quota_exceeded429Kuota harian habisTunggu tetapan semula, atau minta peningkatan
too_many_requests429Terlalu banyak permintaan dalam tetingkap yang singkatCuba semula dengan backoff eksponen
permission_denied403Projek disekat, atau peringkat percuma tidak tersedia untuknyaPautkan 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.

Had Gemini dan Gemma percuma dari katalog hari ini
ModelPercuma padaKonteksHad percuma (tawaran terbaik)AlatPenglihatan
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaYaYa
Gemini Flash (latest alias)Google AI Studio-10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.7 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.6 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.5 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.8 LiveGoogle AI Studio-10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyTidakTidak
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyTidakTidak
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
TidakYa
Gemini 3.5 Flash LiteGoogle AI Studio1M15 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini Flash Lite (latest alias)Google AI Studio-10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa

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

  1. Baca quotaId. Jika ia mengandungi PerDay, berhenti dan tunggu tetapan semula pada tengah malam waktu Pacific.
  2. Untuk had seminit, cuba semula dengan backoff eksponen dan jitter. Tetapkan bilangan percubaan maksimum.
  3. Pindahkan tugas mudah ke model dengan had harian yang lebih tinggi, contohnya model Gemma atau Flash-Lite.
  4. Hantar lebih sedikit token. Prompt besar cepat mencapai had token seminit.
  5. Jangan gunakan max_tokens yang sangat kecil. Gemini Flash boleh menggunakan token penaakulan tersembunyi dalam had output.
Apa yang anda cubaAdakah ia membantu?Mengapa
Cipta kunci API baharu dalam projek yang samaTidakHad dikenakan pada projek. Google menyatakan kunci baharu tidak menyelesaikan ralat.
Naik taraf projek ke peringkat berbayarMemberikan kuota berbayarGoogle menyatakan peringkat berbayar tidak memberikan kuota peringkat percuma. Penggunaan berbayar dicaj.
Tunggu masa retry inYa, untuk had seminitTetingkap seminit ditetapkan semula
Tukar kepada model yang berbezaYaSetiap 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-Trail menyenaraikan setiap hop yang gagal, contohnya google/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

PembekalIsu diketahuiApa yang perlu dilakukan
Google AI StudioThinking tokens use output capGemini 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.

Guna setiap satu daripada ini melalui satu kunci. FreeLLMAPI ialah penghala sumber terbuka yang anda hoskan sendiri. Ia meletakkan semua peringkat percuma ini di belakang satu titik akhir serasi OpenAI dan beralih ke pembekal lain apabila had kadar dicapai. Layari katalog atau mula sekarang.

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

Sumber

Semua panduan · Lihat semua model percuma