Mengatasi error API key

API key tidak berfungsi? Atasi error 401, 402, 403, dan 429

Kenapa API key AI tidak berfungsi: arti error 401, 402, 403, dan 429, kode yang dipakai tiap penyedia saat saldo habis, dan cara mengatasinya.

Diperbarui
  • Saat API key AI "tidak berfungsi", nomor error-nya memberi tahu penyebabnya: 401 berarti key-nya sendiri salah, 402 biasanya berarti saldo atau kreditmu habis, 403 berarti key tidak diizinkan melakukan hal itu, dan 429 berarti terlalu banyak permintaan atau, pada sebagian penyedia, saldo yang kosong.
  • Tiap penyedia memakai kode yang berbeda untuk saldo habis. DeepSeek, OpenRouter, Mistral, Together, Fireworks, dan penagihan prabayar Gemini memakai 402; OpenAI, Kimi, dan Z.ai memakai 429; Qwen dari Alibaba Cloud memakai 403. Baca pesannya, jangan hanya nomornya.
  • Error saldo tidak hilang kalau ditunggu; batas laju (rate limit) biasanya hilang. Tabel di bawah mencantumkan halaman error resmi tiap penyedia, dicek pada 18 November 2026.
Oriveo di iPhone: halaman penyedia, berisi penyedia yang kamu hubungkan dan pengeluaran bulan ini.

Apa sebenarnya arti "API key tidak berfungsi"?

API key adalah kode rahasia yang dikirim aplikasi di setiap permintaan, supaya penyedia AI tahu itu kamu dan akun siapa yang ditagih. Kalau ada yang salah, penyedia membalas dengan error: angka tiga digit yang disebut kode status HTTP, ditambah pesan singkat.

Angkanya menunjukkan jenis masalahnya; pesannya memberi rinciannya. Oriveo mengubah error yang umum menjadi judul yang mudah dipahami, seperti "API key tidak valid" atau "Kuota penyedia habis", yang dijelaskan lebih lanjut di halaman ini.

Panduan cepat: 401, 402, 403, 429, dan 5xx

Mulai dari sini. Cari nomormu, lalu baca bagian yang sesuai di bawah. Ringkasan ini mengikuti halaman error OpenAI, Anthropic, dan penyedia lain per 18 November 2026.

Panduan cepat: 401, 402, 403, 429, dan 5xx
KodeBiasanya berartiHilang kalau ditunggu?Yang perlu dilakukan
401Key-nya salah: ada karakter yang hilang, spasi berlebih, key sudah dihapus, atau key dari penyedia atau wilayah lainTidakSalin ulang key atau buat yang baru; cek penyedia dan wilayahnya
402Perlu pembayaran: saldo prabayar atau kreditmu habis, atau ada masalah tagihanTidakIsi saldo, atau perbaiki metode pembayaran di halaman tagihan penyedia
403Key-nya dikenali tapi tidak diizinkan: negara atau wilayah tidak didukung, tidak punya akses ke model itu, atau ada langkah verifikasiTidakCek wilayah yang didukung, izin key, dan verifikasi yang diminta
404Nama model atau alamatnya salahTidakPilih model lain atau cek alamatnya
429Terlalu banyak permintaan dalam waktu singkat atau, pada sebagian penyedia, saldo kosong atau batas belanja tercapaiSering kali, kalau itu batas lajuTunggu lalu coba lagi; kalau pesannya menyebut quota, balance, credit, atau spend limit, isi saldo atau naikkan batasnya
500–504, 529Gangguan atau beban berlebih di sisi penyediaBiasanyaCoba lagi nanti atau ganti model

Kenapa muncul pesan saldo atau kuota tidak cukup?

Kebanyakan penyedia butuh kredit prabayar atau metode tagihan yang aktif sebelum API bisa dipakai, dan masing-masing melaporkan saldo kosong dengan caranya sendiri. Key baru tidak akan menyelesaikan masalah ini; yang menyelesaikannya adalah menambah kredit.

Ini kode yang didokumentasikan tiap penyedia bawaan Oriveo (15 penyedia) saat saldo atau kreditmu habis. "Tidak disebutkan" berarti dokumentasi penyedia, yang dicek pada 18 November 2026, tidak memberikan kode HTTP untuk kasus ini.

Kenapa muncul pesan saldo atau kuota tidak cukup?
PenyediaKode saat saldo habisIsi pesannyaHalaman resmi
OpenAI429credit_balance_exhausted (tipe error-nya mungkin masih tertulis insufficient_quota)developers.openai.com/api/docs/guides/error-codes
Anthropic (Claude)Tidak disebutkan"Your credit balance is too low to access the Anthropic API"; untuk masalah pembayaran, balasannya 402 billing_errorplatform.claude.com/docs/en/api/errors (kode); platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (pesan)
Google Gemini402 (penagihan prabayar)payment_required; 403 juga bisa berarti tagihan Cloud Billing yang belum dibayaraistudio.google.com/docs/api-errors
OpenRouter402Your account or API key has insufficient creditsopenrouter.ai/docs/api-reference/errors
DeepSeek402Insufficient Balanceapi-docs.deepseek.com/quick_start/error_codes
xAI (Grok)Tidak disebutkanPermintaan ditolak begitu kredit prabayar habisdocs.x.ai/console/billing
Mistral AI402Payment requireddocs.mistral.ai/resources/error-glossary
GroqTidak didokumentasikanGroq menagih setelah pemakaian; halaman error-nya tidak mencantumkan error saldoconsole.groq.com/docs/errors
Together AI402Payment Requireddocs.together.ai/docs/error-codes
Fireworks AI402Payment Requireddocs.fireworks.ai/guides/inference-error-codes
MiniMaxTidak disebutkan (kode bisnis 1008)insufficient balanceplatform.minimax.io/docs/api-reference/errorcode
Z.ai (GLM)429 (kode 1113)Insufficient balance or no resource package. Please recharge.docs.z.ai/api-reference/api-code
Qwen (Alibaba Cloud)403Arrearage atau isv.OUT_OF_SERVICE (akun menunggak)alibabacloud.com/help/en/model-studio/error-code
Kimi (Moonshot AI)429exceeded_current_quota_errorplatform.kimi.ai/docs/api/errors
SiliconFlowTidak didokumentasikanTidak ada error saldo yang tercantumdocs.siliconflow.com/en/faqs/error-code

401: API key tidak valid atau autentikasi gagal

Error 401 berarti penyedia tidak mengenali key-nya. Pesan yang biasa muncul antara lain "Incorrect API key provided" (OpenAI), "authentication_error" (Anthropic), "Authentication Fails" (DeepSeek), dan "Invalid API key: this is not an OpenRouter API key" (OpenRouter).

  • Salin ulang key dari situs penyedia, lalu cek apakah ada karakter yang hilang atau spasi di awal maupun akhir.
  • Pastikan key itu milik penyedia yang kamu pilih. Key OpenAI tidak bisa dipakai sebagai key OpenRouter, begitu pula sebaliknya.
  • Kimi, MiniMax, dan Qwen menjalankan platform regional yang terpisah, dan key dari satu platform tidak berfungsi di platform lain. Di Oriveo, pilih wilayah yang sesuai di pemilih "Titik Akhir Resmi" ("URL permintaan resmi" di iPhone).
  • Kalau key sudah dihapus, dicabut, atau kedaluwarsa, buat key baru.

402: perlu pembayaran atau saldo tidak cukup

Error 402 berarti soal uang: saldo prabayar kosong, atau metode pembayaran gagal. Isi saldo atau perbarui data pembayaran di halaman tagihan penyedia, lalu kirim lagi. Menunggu tidak membantu.

Di Oriveo, ini muncul sebagai "Kuota penyedia habis": "Penyedia melaporkan kuota atau kredit API key ini sudah habis. Periksa tagihan Anda di penyedia, atau ganti model."

403: akses ditolak (forbidden)

Error 403 berarti penyedia mengenali key-nya tapi tidak mengizinkan permintaan itu. Alasannya tergantung penyedia:

  • OpenAI mengembalikan "Country, region, or territory not supported" saat API dipakai dari negara yang tidak didukungnya. Tiap penyedia menerbitkan daftar negara yang didukungnya.
  • Gemini mengembalikan 403 saat project di paket gratis perlu verifikasi (FREE_TIER_VERIFICATION_REQUIRED), saat akun Cloud Billing yang terhubung punya tagihan yang belum dibayar, atau saat Google memblokir key yang dilaporkan bocor.
  • Anthropic mengembalikan permission_error saat key tidak boleh memakai resource itu; cek pengaturan organisasi dan workspace-mu.
  • OpenRouter mengembalikan 403 saat permintaan diblokir oleh izin, moderasi, guardrail, atau batas anggaran.
  • SiliconFlow mewajibkan verifikasi identitas untuk sebagian model.
  • Qwen memakai 403 untuk akun yang menunggak, dan untuk AllocationQuota.FreeTierOnly saat kuota gratis sudah habis dan pengaturan "Free Quota Only" aktif.

429: terlalu banyak permintaan, batas laju, atau kuota terlampaui

Umumnya, 429 berarti kamu mengirim terlalu banyak permintaan atau token dalam waktu singkat. Itu batas laju (rate limit), dan akan hilang kalau kamu menunggu beberapa puluh detik. Kalau balasannya menyertakan waktu Retry-After, tunggu selama itu.

Beberapa penyedia juga memakai 429 untuk saldo kosong atau batas belanja, dan yang ini tidak hilang dengan menunggu: OpenAI (credit_balance_exhausted, atau batas belanja yang kamu tetapkan sendiri), Kimi (exceeded_current_quota_error), Z.ai (kode 1113), dan Anthropic saat organisasi mencapai batas belanja bulanannya (enforced_spend_limit_reached), yang berlaku sampai bulan berikutnya kecuali kamu meminta tingkat yang lebih tinggi.

Paket gratis lebih ketat. Paket gratis Gemini dan model gratis OpenRouter punya batas per menit dan per hari.

Di Oriveo, batas laju muncul sebagai "Tarif Terbatas" di web atau "Tarif Penyedia Terbatas" di iPhone dan Android. Kalau pesannya menyebut kuota atau kredit, Oriveo menampilkan "Kuota penyedia habis".

Apa arti pesan error di Oriveo?

Ini pesan yang mungkin kamu lihat di Oriveo, sesuai tulisannya di aplikasi berbahasa Indonesia:

Apa arti pesan error di Oriveo?
Yang tampil di OriveoArtinyaYang perlu dilakukan
Tersimpan, tetapi kunci tampaknya tidak valid. Anda dapat memverifikasinya nanti di pengaturan penyedia.Oriveo sudah menyimpan penyedianya, tapi penyedia menolak key saat pengecekanSalin ulang key lalu perbarui di pengaturan penyedia itu
API key tidak validPenyedia mengembalikan 401 atau 403Cek atau ganti key; untuk 403, cek wilayah dan izinnya
Kuota penyedia habisPenyedia menyatakan kredit atau kuota untuk key ini sudah habis (402, atau 429 yang menyebut kuota)Isi saldo di penyedia, atau beralih ke model lain
Tarif Terbatas (web) / Tarif Penyedia Terbatas (iPhone dan Android)Terlalu banyak permintaan untuk saat ini (429)Tunggu sebentar lalu coba lagi
Kuota gratis habis (web dan iPhone) / Kuota Gratis Tercapai (Android)Jatah Oriveo Free hari ini sudah habis; ini tidak ada hubungannya dengan key-mu sendiriTambahkan API key sendiri, atau tunggu reset pukul 00:00 UTC
Layar Penyedia Oriveo dengan daftar penyedia yang terhubung, seperti OpenAI, Z.ai, Groq, Gemini, dan Anthropic, masing-masing dengan pengeluarannya
Buka salah satu penyedia di daftar ini untuk mengecek atau mengganti key-nya.

Memakai endpoint kustom, relay, atau gateway?

Kalau kamu terhubung lewat endpoint kustom, error-nya bisa berasal dari layanan itu atau dari penyedia di belakangnya. Saat Oriveo menampilkan "Koneksi ini tidak dapat menghubungi penyedia upstream-nya.", akun milik layanan itu di penyedia mungkin tidak valid, kehabisan kredit, atau terkena batas laju. Itu bukan kesalahan pengaturanmu; beralihlah ke koneksi lain atau hubungi pengelola layanannya.

Cek ini dulu sebelum membuat key baru

Key baru hampir hanya bisa mengatasi error 401. Periksa daftar ini dulu:

  • Kamu memilih penyedia yang benar dan, untuk Kimi, MiniMax, Qwen, SiliconFlow, dan Z.ai, wilayah yang benar.
  • Kamu menyalin key secara utuh, tanpa spasi.
  • Akunmu punya kredit, atau metode tagihan yang aktif.
  • Negara atau wilayahmu ada di daftar yang didukung penyedia.
  • Model yang kamu pilih tersedia untuk akun atau tingkatanmu.

Pertanyaan umum seputar aplikasi

Kenapa API key-ku tidak berfungsi?
Lihat nomor error-nya. 401 berarti key salah, 402 berarti saldo atau kreditmu habis, 403 berarti permintaan tidak diizinkan (sering karena wilayah atau izin), dan 429 berarti terlalu banyak permintaan atau, pada sebagian penyedia, saldo kosong.
Apa arti error 401 pada API key?
Penyedia tidak mengenali key-nya. Salin ulang tanpa spasi, pastikan key itu milik penyedia dan wilayah yang kamu pilih, atau buat key baru.
Apa itu error 402 Payment Required?
Saldo prabayar atau kreditmu habis, atau ada masalah pembayaran. DeepSeek, OpenRouter, Mistral, Together, Fireworks, dan penagihan prabayar Gemini memakai kode ini. Isi saldo di halaman tagihan penyedia; menunggu tidak akan menyelesaikannya.
Error 429 itu batas laju atau masalah kuota?
Bisa keduanya. Biasanya itu batas laju yang hilang setelah menunggu sebentar. Tapi OpenAI, Kimi, dan Z.ai juga mengembalikan 429 saat saldomu kosong, jadi kalau pesannya menyebut quota, balance, atau credit, isi kredit alih-alih menunggu.
Kenapa API key OpenAI-ku memunculkan insufficient_quota?
Akun API OpenAI-mu sudah tidak punya kredit prabayar. OpenAI mengembalikan 429 dengan kode credit_balance_exhausted, dan tipe error-nya mungkin masih tertulis insufficient_quota. Isi kredit di pengaturan tagihan OpenAI; key baru tidak akan membantu.
Kenapa API key baruku tidak berfungsi padahal sudah disalin dengan benar?
Biasanya karena akunnya belum punya kredit atau tagihannya belum diatur, key-nya milik wilayah lain, atau API itu tidak tersedia di negaramu. Cek hal-hal itu sebelum membuat key lagi.

Bacaan terkait

Dari blog

Pesan error yang mudah dipahami untuk setiap key

Buka aplikasi web atau unduh Oriveo untuk iPhone atau Android, tambahkan key dari 15 penyedia, dan dapatkan alasan yang jelas saat permintaan gagal.

Belum punya API key? Mulai dengan Oriveo Free.