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.

Cent AITerbit 3 menit baca

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. export di 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 curlKemungkinan penyebabPerbaikan
401, Incorrect API key provided (OpenAI)Key salah ketik, terpotong, atau dicabutSalin ulang key tanpa spasi, atau buat key baru
401, invalid x-api-key (Anthropic)Key salah ketik, terpotong, dicabut, atau bukan key AnthropicSalin ulang key dari Console, cek nama variabel
429, credit_balance_exhausted (OpenAI)Organisasi tidak punya kredit prabayarTambah kredit di organisasi pemilik key
402, billing_error (Anthropic)Data billing atau pembayaranPerbaiki billing di Console
curl berhasil, aplikasi gagalAplikasi membaca variabel lain, .env lama, atau base URL lainCetak 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:

KodeHTTPArti
invalid_api_key401Key salah, dicabut, atau milik akun yang diblokir
insufficient_balance402Tidak ada saldo untuk model ini
model_not_found404Nama model tidak ada di daftar model
rate_limited429Lebih dari 600 request per menit di key ini
key_limit_exceeded429Key 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

  1. developers.openai.com/api/docs/guides/error-codes (membuka tab baru) · diakses 2026-11-14
  2. platform.claude.com/docs/en/api/errors (membuka tab baru) · diakses 2026-11-14
  3. cent-ai.dev/id/docs/reference/errors (membuka tab baru) · diakses 2026-11-14
  4. cent-ai.dev/id/docs/reference/errors/4xx (membuka tab baru) · diakses 2026-11-14
BagikanXThreads