Error 429 OpenAI dan 401 Anthropic: cek dengan curl
Arti error 429 credit_balance_exhausted dari OpenAI dan 401 "invalid x-api-key" dari Anthropic, cara membedakan penyebabnya dengan satu perintah curl, dan cara memperbaikinya.
Dua error ini sering menghentikan proyek AI: 429 dari OpenAI yang menyebut kredit habis, dan 401 dari Anthropic yang menyebut key tidak valid. Keduanya terlihat seperti "API-nya rusak", padahal penyebabnya bisa dipersempit. Artikel ini menjelaskan arti tiap error, cara menemukan penyebabnya dengan satu perintah curl, dan cara memperbaikinya.
OpenAI 429 credit_balance_exhausted
Panduan kode error OpenAI mencantumkan "429 - Credit balance exhausted" dengan kode credit_balance_exhausted. Penyebab yang disebut: "Your organization has no prepaid credits remaining", yaitu organisasi Anda tidak punya kredit prabayar lagi. Solusinya: "Add credits to continue using the API" (sumber). Halaman yang sama mencatat bahwa error.type yang lebih umum masih bisa berisi insufficient_quota, jadi kode lama yang hanya mengecek type tetap berjalan.
429 ini bukan rate limit. Menunggu lalu mencoba lagi tidak membantu, karena tidak ada request yang diterima sampai organisasi punya kredit lagi. Dua hal yang perlu dicek:
- Organisasi yang benar. Kredit melekat pada organisasi. Key yang dibuat di organisasi lain, atau di project milik organisasi tanpa kredit, tetap mendapat 429 walaupun organisasi utama Anda punya kredit.
- Saldonya sendiri. Buka halaman billing organisasi dan pastikan kreditnya di atas nol.
Anthropic 401 invalid x-api-key
Referensi error Anthropic mencantumkan "401 - authentication_error: There's an issue with your API key", artinya ada masalah dengan API key Anda (sumber). Kami mengirim request dengan key karangan pada 2026-11-14 dan mendapat body ini:
{"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"},"request_id":"req_<redacted>"}
Penyebab yang biasa:
- Key terpotong atau berisi spasi. Key yang disalin dari chat atau dokumen sering membawa spasi, baris baru, atau kehilangan karakter terakhir.
- Variabel environment tidak ada di shell ini.
exportdi satu terminal tidak terbawa ke terminal lain, IDE, atau service. - Key salah untuk endpoint-nya. Key OpenAI yang dikirim ke Anthropic, atau key dari gateway lain, selalu mendapat 401.
- Key sudah dicabut di Console, atau milik workspace yang sudah diarsipkan.
Anthropic juga punya error terpisah "402 - billing_error: There's an issue with your billing or payment information", yaitu masalah billing atau data pembayaran (sumber). 401 soal key; 402 soal billing.
Cari penyebabnya dengan curl
Jalankan satu request di luar aplikasi Anda. Bila berhasil dengan curl tetapi gagal di aplikasi, masalahnya ada di cara aplikasi membaca key, bukan di key-nya.
Untuk OpenAI:
curl https://api.openai.com/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY"
Untuk Anthropic:
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"YOUR_MODEL","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'
Sebelum menyalahkan key, pastikan shell benar-benar memegangnya: echo ${#OPENAI_API_KEY} mencetak panjang key, dan 0 berarti variabelnya kosong.
| Hasil curl | Kemungkinan penyebab | Perbaikan |
|---|---|---|
401, Incorrect API key provided (OpenAI) | Key salah ketik, terpotong, atau dicabut | Salin ulang key tanpa spasi, atau buat key baru |
401, invalid x-api-key (Anthropic) | Key salah ketik, terpotong, dicabut, atau bukan key Anthropic | Salin ulang key dari Console, cek nama variabel |
429, credit_balance_exhausted (OpenAI) | Organisasi tidak punya kredit prabayar | Tambah kredit di organisasi pemilik key |
402, billing_error (Anthropic) | Data billing atau pembayaran | Perbaiki billing di Console |
| curl berhasil, aplikasi gagal | Aplikasi membaca variabel lain, .env lama, atau base URL lain | Cetak panjang key dan base URL dari dalam aplikasi |
Kalau Anda membayar dengan saldo di Cent AI
Cent AI melayani kedua format: OpenAI di https://api.cent-ai.dev/v1 dan Anthropic Messages di https://api.cent-ai.dev. Key yang sama berlaku di Authorization: Bearer dan di x-api-key. Error dikembalikan dalam format endpoint yang Anda panggil, jadi cek di atas tetap berlaku. Key yang salah menghasilkan:
{"error":{"code":"invalid_api_key","message":"Invalid API key. Check the key or create a new one in the dashboard.","param":null,"type":"authentication_error"}}
Kode yang paling mungkin Anda temui:
| Kode | HTTP | Arti |
|---|---|---|
invalid_api_key | 401 | Key salah, dicabut, atau milik akun yang diblokir |
insufficient_balance | 402 | Tidak ada saldo untuk model ini |
model_not_found | 404 | Nama model tidak ada di daftar model |
rate_limited | 429 | Lebih dari 600 request per menit di key ini |
key_limit_exceeded | 429 | Key mencapai batas harian atau bulanan yang Anda pasang |
Setiap respons punya header x-request-id, dan ID yang sama ada di halaman Requests di dashboard. Request yang ditolak sebelum sampai ke model tidak ditagih. Daftar lengkapnya ada di Errors.
Saldonya prabayar: top-up lewat QRIS dalam rupiah, atau dengan USDT atau USDC di jaringan Solana (biaya jaringan dari dompet Anda ditanggung sendiri). Setiap pembayaran dilakukan manual, tanpa kartu tersimpan dan tanpa perpanjangan otomatis, jadi 402 berarti saldo habis, bukan kartu yang gagal.
Sumber
- developers.openai.com/api/docs/guides/error-codes (membuka tab baru) · diakses 2026-11-14
- platform.claude.com/docs/en/api/errors (membuka tab baru) · diakses 2026-11-14
- cent-ai.dev/id/docs/reference/errors (membuka tab baru) · diakses 2026-11-14
- cent-ai.dev/id/docs/reference/errors/4xx (membuka tab baru) · diakses 2026-11-14
Artikel terkait
- Kartu ditolak saat bayar API AI? Ini yang bisa dicekpayment · 3 mntHal-hal umum yang bisa dicek saat kartu debit atau kredit ditolak ketika membeli kredit API AI, dan alternatif prabayar lewat QRIS atau USDT/USDC.
- OpenCode dan Cline dengan API bayar rupiahopencode · 2 mntPasang OpenCode dan Cline CLI ke API yang dibayar dengan QRIS, langkah yang kami uji di OpenCode 2.3.0 dan Cline 3.0.74, plus biaya nyata satu giliran.
- Provider custom Codex CLI di config.tomlcodex · 3 mntTambahkan provider model custom ke Codex CLI di ~/.codex/config.toml dengan wire_api = "responses", simpan key di variabel environment, lalu cek dengan satu request curl.