OpenAI “Anda telah melampaui kuota saat ini” (insufficient_quota) — mengapa menunggu tidak pernah menyelesaikannya

Inilah 429 yang tidak dapat diperbaiki dengan backoff. insufficient_quota berarti akun Anda tidak memiliki kredit yang dapat digunakan — permintaan ditolak sebelum model berjalan dan akan terus ditolak sampai status penagihan berubah. Berikut cara memastikan status penagihan Anda dan memperbaikinya dalam hitungan menit.

Error

respons (HTTP 429)

{
  "error": {
    "message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.",
    "type": "insufficient_quota",
    "param": null,
    "code": "insufficient_quota"
  }
}

Ringkasan penyebab dan perbaikan

Penyebab	Perbaikan
Saldo kredit prabayar adalah $0	API menggunakan sistem prabayar: beli kredit (atau aktifkan pengisian ulang otomatis) di Settings → Billing. Kartu yang tersimpan saja tidak menambahkan apa pun sampai kredit dibeli.
Kredit uji coba gratis kedaluwarsa atau telah digunakan	Pemberian kredit uji coba kedaluwarsa (biasanya setelah 3 bulan) meskipun belum digunakan. Solusinya sama: tambahkan metode pembayaran dan beli kredit.
Batas anggaran bulanan tercapai	Anggaran yang Anda tetapkan sendiri di bawah Limits memblokir permintaan hingga akhir bulan setelah tercapai. Naikkan batasnya atau tunggu sampai bulan berganti.
Kunci milik proyek atau organisasi tanpa anggaran	Pengeluaran kunci sk-proj- berasal dari proyeknya; proyek dapat memiliki batasnya sendiri yang lebih rendah daripada organisasi. Periksa proyek kunci tersebut di dasbor, bukan hanya total organisasi.

Pastikan ini masalah kuota, bukan pembatasan laju

Baca error.type. rate_limit_exceeded akan hilang sendiri dalam satu menit dan memerlukan backoff; insufficient_quota tidak akan hilang sendiri dan retry hanya menghasilkan gangguan. Jika tidak yakin, lakukan satu retry setelah 60 detik: jika masih 429 dengan pesan yang sama, berarti masalah penagihan.

Periksa saldo kredit dari mana kunci benar-benar membelanjakan kredit

Di platform.openai.com → Settings → Billing, periksa saldo kredit. Jika nol atau negatif, beli kredit. Kemudian periksa Settings → Limits untuk batas anggaran bulanan, dan — untuk kunci sk-proj- — batas penggunaan proyek pemiliknya. Ketiganya dapat secara independen menghasilkan kesalahan ini.

Hentikan penyebab berulangnya, bukan hanya insidennya

Aktifkan pengisian ulang otomatis dengan ambang yang wajar agar akhir pekan yang sibuk tidak mematikan produksi, dan tetapkan peringatan anggaran (bukan hanya batas keras) agar Anda mengetahui batas yang mendekat sebelum permintaan mulai gagal.

Jika Anda melakukan panggilan melalui Kunavo

Kunavo menggunakan model prabayar yang sama, jadi perbandingan jujurnya berkaitan dengan cakupan dampak dompet, bukan mekanismenya: satu saldo Kunavo mencakup GPT dan Claude sekaligus, dengan harga per token, dan permintaan yang gagal tidak pernah ditagih. Saat saldo Kunavo sendiri habis, Anda menerima 402 dengan kode insufficient_quota (sengaja menggunakan kode yang sama agar penanganan kesalahan OpenAI SDK tetap berlaku) — pengisian saldo menghapusnya secara instan, tanpa batas bulanan yang perlu diatasi. Jika Anda sedang menyusun anggaran untuk perbaikan ini, tarif GPT per token saat ini, dengan harga resmi OpenAI di samping harga kami, tersedia di daftar harga GPT API.

Pertanyaan umum

Saya sudah menambahkan kartu kredit — mengapa saya masih mendapatkan insufficient_quota?

Karena API menggunakan kredit prabayar, bukan kartu secara langsung. Menambahkan kartu hanya memungkinkan pembelian; Anda tetap harus membeli kredit atau mengaktifkan pengisian ulang otomatis. Kesalahan tersebut hilang dalam satu atau dua menit setelah saldo menjadi positif.

Apakah insufficient_quota pernah pulih dengan sendirinya?

Hanya dalam satu kasus: batas anggaran bulanan, yang direset ketika bulan berganti. Kasus saldo nol dan uji coba kedaluwarsa tetap berlangsung sampai Anda membeli kredit. Bagaimanapun, loop retry tidak membantu — permintaan ditolak sebelum model berjalan.

Apakah permintaan 429 yang gagal menimbulkan biaya?

Tidak — OpenAI menolaknya sebelum inferensi, dan di Kunavo permintaan yang gagal juga tidak pernah ditagih. Biayanya adalah waktu henti, itulah sebabnya pengisian ulang otomatis ditambah peringatan anggaran lebih baik daripada hanya menggunakan batas keras.

Panduan terkait

Detail semantik error lainnya tersedia di referensi error; mendapatkan kunci hanya perlu satu menit melalui pendaftaran dan panduan autentikasi.