Kode kesalahan API

Kode kesalahan umum saat memanggil Kimi API dan cara mengatasinya.

Referensi kode kesalahan

Kode KesalahanArtiSolusi
400Bad RequestPeriksa format isi permintaan, nama parameter, dan tipenya. Penyebab umum: JSON yang rusak, parameter wajib yang hilang, atau nilai di luar rentang.
401UnauthorizedPastikan API Key benar, belum kedaluwarsa, dan tidak dinonaktifkan. Konfirmasi format header: Authorization: Bearer <your-api-key>.
403Forbidden (saldo tidak cukup)Saldo akun habis — lakukan top up di konsol. Akun juga mungkin dibatasi; hubungi dukungan jika diperlukan.
404Not FoundPeriksa jalur URL permintaan dan nama model. Pastikan endpoint adalah https://api.moonshot.ai/v1/....
429Too Many RequestsMelebihi rate limit. Kurangi frekuensi, terapkan exponential backoff, atau hubungi dukungan untuk menaikkan batas.
500Internal Server ErrorMasalah server sementara — coba lagi nanti. Jika berlanjut, hubungi [email protected] dengan menyertakan request_id.

Tips pemecahan masalah umum

  1. Periksa pesan kesalahan lengkap: JSON respons menyertakan error.message dengan deskripsi terperinci.
  2. Catat request_id: Membantu tim dukungan menemukan masalah dengan cepat.
  3. Rujuk dokumentasi resmi: Pastikan panggilan sesuai dengan dokumentasi di platform.kimi.ai.
  4. Terapkan logika coba ulang: Untuk kesalahan 429 dan 500, gunakan exponential backoff.