RESOURCE_EXHAUSTED adalah 429 serbaguna milik Gemini. Jika hilang setelah satu menit, Anda terkena batas laju — backoff akan memperbaikinya. Jika berlangsung hingga tengah malam waktu Pasifik, Anda telah menghabiskan kuota tingkat gratis harian — tidak ada loop retry yang dapat memperbaikinya; hanya penagihan atau rute lain yang bisa.
Error
{
"error": {
"code": 429,
"message": "Resource has been exhausted (e.g. check quota).",
"status": "RESOURCE_EXHAUSTED"
}
}Ringkasan penyebab dan perbaikan
| Penyebab | Perbaikan |
|---|---|
| Batas laju per menit (RPM/TPM) | Gunakan backoff dengan jitter; ratakan lonjakan. Pulih dalam ~60 detik. |
| Kuota permintaan tingkat gratis harian habis | Tunggu hingga reset harian — aktifkan penagihan, naikkan kuota, atau rutekan melalui gateway berbayar. |
| Banyak worker berbagi satu kunci | Kuota berlaku per proyek, bukan per worker — pusatkan rate limiter atau pecah penggunaan di beberapa proyek/kunci. |
Klasifikasikan: batas menit atau kuota harian
Coba sekali lagi setelah 60 detik. Berhasil → batas laju skala menit (tambahkan backoff dan lanjutkan). Masih 429 → kuota harian; periksa Cloud Console → Quotas untuk penghitung tepat yang mencapai 100%.
Untuk batas menit: backoff standar
Gunakan pola yang sama seperti setiap 429 — eksponensial, dengan jitter, dan hanya retry status yang dapat dicoba ulang. Gunakan kembali cuplikan dari panduan Claude 429 kami tanpa perubahan; pola ini agnostik terhadap penyedia.
Untuk kuota harian: ubah ekonominya
Kuota tingkat gratis ditujukan untuk pembuatan prototipe. Produksi memerlukan penagihan yang diaktifkan pada proyek — atau gateway pay-as-you-go dengan batas yang ditentukan dompet Anda, bukan penghitung harian. Bandingkan perhitungan per token sebelum memilih.
Jika Anda melakukan panggilan melalui Kunavo
Di Kunavo, Gemini 2.5 Flash/Pro menggunakan skema pay-as-you-go dalam satu dompet prabayar — tidak ada penghitung tingkat gratis harian yang dapat habis, dan permintaan yang gagal tidak ditagihkan. Untuk beban kerja yang terus mencapai kuota harian AI Studio, harga per token (jauh di bawah harga resmi Google) biasanya lebih murah daripada waktu rekayasa yang dihabiskan untuk memecah proyek.
Pertanyaan umum
Kapan kuota tingkat gratis Gemini direset?
Kuota harian direset pada tengah malam waktu Pasifik. Batas per menit direset dalam jendela bergulir 60 detik.
Apakah backoff akan memperbaiki RESOURCE_EXHAUSTED?
Hanya jenis per menit. Kuota harian yang habis akan mengembalikan 429 pada setiap retry hingga reset — deteksi kasus tersebut (429 tetap muncul setelah menunggu 60 detik) dan hentikan retry yang sia-sia.
Panduan terkait
Detail semantik error lainnya tersedia di referensi error; mendapatkan kunci hanya perlu satu menit melalui pendaftaran dan panduan autentikasi.