Bantuan

Ringkasan

Sebagian besar masalah bisa kamu pastikan sendiri dalam satu menit. Halaman ini menunjukkan caranya, lalu menyebutkan apa yang perlu disertakan kalau memang perlu ditelusuri.

Dokumentasi ini tidak mencantumkan alamat dukungan, karena kanalnya berbeda-beda dan alamat yang salah di dokumentasi lebih buruk daripada tidak ada alamat. Kirim laporanmu lewat kanal tempat kamu mendapatkan akses ke akun ini.

Urutan pemeriksaan

Periksa dari luar ke dalam. Setiap langkah memisahkan satu kemungkinan.

1. API hidup. curl -s https://api.nusarouter.web.id/healthz harus menjawab {"ok":true}. Kalau tidak, host-nya yang bermasalah, bukan kodemu.
2. Model-nya ada. Ambil id dari katalog publik dan pakai persis string itu.
3. Key-nya berlaku. Coba request yang sama di Playground. Playground memakai jalur yang sama, jadi kalau di sana berhasil, masalahnya ada di kodemu, bukan di akun atau saldo.
4. Saldo dan batas. Periksa saldo di konsol, dan periksa apakah key yang kamu pakai punya batas belanja yang sudah habis.

Membaca error-nya

Selalu baca code di body, bukan hanya status HTTP-nya.

curl -s -o - -w '\nHTTP %{http_code}\n' \
  https://api.nusarouter.web.id/v1/chat/completions \
  -H "Authorization: Bearer sk-nusa-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-flash-v4.1","messages":[{"role":"user","content":"Halo"}]}'

Satu status bisa berarti dua hal yang berbeda obatnya. 402 bisa berarti saldo dompet habis atau batas key habis, dan 429 bisa berarti batas per menit atau batas konkurensi. code-nya yang membedakan.

Cara baca yang sama berlaku di permukaan Anthropic (POST /v1/messages), tapi envelope error-nya beda. Lihat Format Anthropic.

Daftar lengkapnya ada di Error dan status.

Saat melapor

Sertakan yang berikut ini, dan penelusurannya jauh lebih cepat.

• Body error lengkapnya: termasuk message, type, dan code.
• Waktu kejadiannya, sedetail mungkin. Log kami berbasis waktu, jadi jam yang tepat mempersempit pencarian dari berjam-jam menjadi beberapa detik.
• Id dari response kalau request-nya sempat berhasil sebagian. id di response chat menunjuk ke satu request tertentu.
• Perintah atau potongan kode yang kamu jalankan. Untuk masalah chat, satu perintah curl lebih berguna daripada penjelasan panjang.
• Referensi pembayaran untuk masalah saldo, bukan bukti transfernya, cukup referensinya.

Troubleshooting