Arti error API AI dan cara memperbaikinya
Pesan error API AI kebanyakan berbahasa Inggris dan singkat. Halaman ini menjelaskan artinya dalam bahasa Indonesia, penyebab paling sering, dan langkah perbaikan yang berlaku untuk key dari OpenAI, Anthropic, Google maupun gateway.
Dicek · Sumber: dokumentasi Ezkielyna API · halaman status
Pilih error yang kamu lihat
| Kode | Error | Artinya |
|---|---|---|
| 401 | Invalid API key | Server menolak key: salah salin, sudah dihapus, atau key dikirim ke server lain. |
| 401 | 401 Unauthorized | Header otorisasi hilang, salah format, atau key ditolak. |
| 403 | Insufficient quota / saldo habis | Key valid, tapi saldo atau batas pemakaian key habis. |
| 404 | Model not found / 404 | Nama model salah, key tanpa akses ke model itu, atau base URL salah. |
| 429 | 429 Rate limit exceeded | Terlalu banyak request dalam waktu singkat, atau penyedia model sedang penuh. |
| 400 | Context length exceeded | Input ditambah output yang diminta melebihi jendela konteks model. |
| 502/504 | 502, 503, 504 & timeout | Server di belakang gateway gangguan, penuh, atau terlalu lama menjawab. |
Cek cepat sebelum membuka halaman detail
- Base URL sesuai klien: format OpenAI diakhiri
/v1, Claude Code dan klien format Anthropic tanpa/v1. - Key berasal dari penyedia yang sama dengan base URL, disalin utuh tanpa spasi.
- Nama model persis seperti di daftar model, dan key-mu punya akses ke model itu.
- Saldo dan batas pemakaian key masih ada.
- Kalau error 5xx, ulangi dengan jeda dan cek halaman status penyedia.
Pertanyaan umum
Bagaimana cara tahu error dari aplikasi saya atau dari server?
Lihat kode HTTP-nya. Kode 4xx (400, 401, 403, 404, 413, 429) biasanya karena request: key, saldo, nama model, ukuran atau kecepatan. Kode 5xx (500, 502, 503, 504) biasanya dari server atau penyedia model, dan sering selesai dengan retry berjeda.
Error mana yang memotong saldo?
Request yang ditolak sebelum diproses, seperti key salah atau nama model salah, tidak memakai token. Di Ezkielyna, request chat yang gagal karena error server atau upstream sebelum ada jawaban dikembalikan otomatis ke saldo (Gagal = Gratis). Detail biaya setiap request ada di menu Log.
Apakah panduan ini hanya untuk Ezkielyna?
Tidak. Langkah perbaikan di setiap halaman berlaku untuk key dari OpenAI, Anthropic, Google dan gateway lain. Bagian "Di Ezkielyna API" menjelaskan pesan dan solusi khusus untuk key Ezkielyna.
In English
Indonesian explanations of common AI API errors (invalid API key incl. Claude Code "Please run /login", 401, 429, insufficient quota, model not found / wrong /v1 base URL, context length exceeded, 502/503/504 timeouts): meaning, causes, generic fixes for any provider, and how each error looks on Ezkielyna API.