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.
- 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.

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.
| Kode | Biasanya berarti | Hilang kalau ditunggu? | Yang perlu dilakukan |
|---|---|---|---|
| 401 | Key-nya salah: ada karakter yang hilang, spasi berlebih, key sudah dihapus, atau key dari penyedia atau wilayah lain | Tidak | Salin ulang key atau buat yang baru; cek penyedia dan wilayahnya |
| 402 | Perlu pembayaran: saldo prabayar atau kreditmu habis, atau ada masalah tagihan | Tidak | Isi saldo, atau perbaiki metode pembayaran di halaman tagihan penyedia |
| 403 | Key-nya dikenali tapi tidak diizinkan: negara atau wilayah tidak didukung, tidak punya akses ke model itu, atau ada langkah verifikasi | Tidak | Cek wilayah yang didukung, izin key, dan verifikasi yang diminta |
| 404 | Nama model atau alamatnya salah | Tidak | Pilih model lain atau cek alamatnya |
| 429 | Terlalu banyak permintaan dalam waktu singkat atau, pada sebagian penyedia, saldo kosong atau batas belanja tercapai | Sering kali, kalau itu batas laju | Tunggu lalu coba lagi; kalau pesannya menyebut quota, balance, credit, atau spend limit, isi saldo atau naikkan batasnya |
| 500–504, 529 | Gangguan atau beban berlebih di sisi penyedia | Biasanya | Coba 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.
| Penyedia | Kode saat saldo habis | Isi pesannya | Halaman resmi |
|---|---|---|---|
| OpenAI | 429 | credit_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_error | platform.claude.com/docs/en/api/errors (kode); platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (pesan) |
| Google Gemini | 402 (penagihan prabayar) | payment_required; 403 juga bisa berarti tagihan Cloud Billing yang belum dibayar | aistudio.google.com/docs/api-errors |
| OpenRouter | 402 | Your account or API key has insufficient credits | openrouter.ai/docs/api-reference/errors |
| DeepSeek | 402 | Insufficient Balance | api-docs.deepseek.com/quick_start/error_codes |
| xAI (Grok) | Tidak disebutkan | Permintaan ditolak begitu kredit prabayar habis | docs.x.ai/console/billing |
| Mistral AI | 402 | Payment required | docs.mistral.ai/resources/error-glossary |
| Groq | Tidak didokumentasikan | Groq menagih setelah pemakaian; halaman error-nya tidak mencantumkan error saldo | console.groq.com/docs/errors |
| Together AI | 402 | Payment Required | docs.together.ai/docs/error-codes |
| Fireworks AI | 402 | Payment Required | docs.fireworks.ai/guides/inference-error-codes |
| MiniMax | Tidak disebutkan (kode bisnis 1008) | insufficient balance | platform.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) | 403 | Arrearage atau isv.OUT_OF_SERVICE (akun menunggak) | alibabacloud.com/help/en/model-studio/error-code |
| Kimi (Moonshot AI) | 429 | exceeded_current_quota_error | platform.kimi.ai/docs/api/errors |
| SiliconFlow | Tidak didokumentasikan | Tidak ada error saldo yang tercantum | docs.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:
| Yang tampil di Oriveo | Artinya | Yang perlu dilakukan |
|---|---|---|
| Tersimpan, tetapi kunci tampaknya tidak valid. Anda dapat memverifikasinya nanti di pengaturan penyedia. | Oriveo sudah menyimpan penyedianya, tapi penyedia menolak key saat pengecekan | Salin ulang key lalu perbarui di pengaturan penyedia itu |
| API key tidak valid | Penyedia mengembalikan 401 atau 403 | Cek atau ganti key; untuk 403, cek wilayah dan izinnya |
| Kuota penyedia habis | Penyedia 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 sendiri | Tambahkan API key sendiri, atau tunggu reset pukul 00:00 UTC |

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?
Apa arti error 401 pada API key?
Apa itu error 402 Payment Required?
Error 429 itu batas laju atau masalah kuota?
Kenapa API key OpenAI-ku memunculkan insufficient_quota?
Kenapa API key baruku tidak berfungsi padahal sudah disalin dengan benar?
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.