Beranda / Panduan / Kuota Gemini API terlampaui (429 RESOURCE_EXHAUSTED)

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.
  • quotaMetric menunjukkan apa yang habis. generate_content_free_tier_requests menghitung permintaan pada paket gratis.
  • quotaId menunjukkan jendela waktunya. PerDay adalah kuota harian. ID PerMinute adalah batas per menit.
  • limit adalah kuota Anda untuk model itu pada jendela tersebut.
  • Please retry in memberikan 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:

Dari halaman error Gemini API
KodeHTTPArtiPerbaikan
rate_limit_exceeded429Batas permintaan atau token per menit atau per detik tercapaiCoba lagi dengan backoff eksponensial
quota_exceeded429Kuota harian sudah habisTunggu reset, atau minta peningkatan
too_many_requests429Terlalu banyak permintaan dalam jendela waktu yang singkatCoba lagi dengan backoff eksponensial
permission_denied403Proyek dibatasi, atau paket gratis tidak tersedia untuknyaTautkan 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.

Batas paket gratis Gemini dan Gemma dari katalog saat ini
ModelGratis diKonteksBatas gratis (penawaran terbaik)AlatPemrosesan gambar
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaYaYa
Gemini Flash (latest alias)Google AI Studio-10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.7 FlashGoogle AI Studio1M10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.6 FlashGoogle AI Studio1M10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.5 FlashGoogle AI Studio1M10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.8 LiveGoogle AI Studio-10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~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/menit
20 permintaan/hari
250,000 token/menit
~3M
TidakYa
Gemini 3.5 Flash LiteGoogle AI Studio1M15 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini Flash Lite (latest alias)Google AI Studio-10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa

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

  1. Baca quotaId. Jika berisi PerDay, berhenti dan tunggu reset pada tengah malam waktu Pasifik.
  2. Untuk batas per menit, coba lagi dengan backoff eksponensial dan jitter. Tetapkan jumlah percobaan ulang maksimum.
  3. Pindahkan tugas sederhana ke model dengan batas harian lebih tinggi, misalnya model Gemma atau Flash-Lite.
  4. Kirim lebih sedikit token. Prompt besar cepat mencapai batas token per menit.
  5. Jangan gunakan max_tokens yang sangat kecil. Gemini Flash dapat memakai token penalaran tersembunyi di dalam batas keluaran.
Yang Anda cobaApakah membantu?Alasan
Buat kunci API baru di proyek yang samaTidakBatas berlaku untuk proyek. Google menyatakan kunci baru tidak menyelesaikan error ini.
Tingkatkan proyek ke paket berbayarMemberi kuota berbayarGoogle menyatakan bahwa paket berbayar tidak memberi kuota paket gratis. Penggunaan berbayar ditagih.
Tunggu waktu retry inYa, untuk batas per menitJendela menit berganti
Ganti ke model lainYaSetiap 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-Trail mencantumkan setiap lompatan yang gagal, misalnya google/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

PenyediaMasalah yang diketahuiYang harus 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 dari katalog FreeLLMAPI (versi 2026.11.19, diperiksa 2026-11-19). Batas gratis sering berubah. Katalog diperiksa setiap hari.

Gunakan semua ini melalui satu kunci. FreeLLMAPI adalah router sumber terbuka yang Anda hosting sendiri. Router ini menempatkan semua paket gratis ini di balik satu endpoint yang kompatibel dengan OpenAI, dan beralih ke penyedia lain saat batas permintaan tercapai. Lihat katalog atau mulai.

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

Sumber

Semua panduan · Lihat semua model gratis