Bantuan
Mendiagnosis sendiri, dan apa yang perlu disertakan saat melapor.
Di halaman ini5 bagianTutup
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.
- API hidup.
curl -s https://api.menvorainterasia.com/healthzharus menjawab{"ok":true}. Kalau tidak, host-nya yang bermasalah, bukan kodemu. - Model-nya ada. Ambil id dari katalog publik dan pakai persis string itu. Untuk rute media, periksa juga
capabilities-nya: model yang tidak mendeklarasikan kemampuan yang diminta rute akan ditolak sebelum request dijalankan. - Key-nya berlaku. Coba request yang sama di Playground, di mode Chat atau Media sesuai rutenya: jalurnya sama, jadi kalau di sana berhasil, masalahnya ada di kodemu, bukan di akun atau saldo. Mode Media menjalankan gambar, audio, embeddings, dan decisions, dan daftar bentuk yang muncul mengikuti kapabilitas model yang kamu pilih.
- 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.menvorainterasia.com/v1/chat/completions \
-H "Authorization: Bearer sk-menv-..." \
-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.
Rute media memakai envelope error yang sama, jadi cara bacanya tidak berubah: code di body tetap yang membedakan. Bedanya, kegagalan di sana lebih sering soal model daripada soal body.
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, dancode. - 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.
iddi response chat menunjuk ke satu request tertentu. - Perintah atau potongan kode yang kamu jalankan. Untuk masalah chat maupun media, satu perintah curl lebih berguna daripada penjelasan panjang.
- Referensi pembayaran untuk masalah saldo, bukan bukti transfernya, cukup referensinya.
Troubleshooting#
Tiga baris terakhir adalah penolakan kapabilitas, dan paling sering muncul di rute media: gambar, suara, dan vektor. Ketiganya diperiksa sebelum saldo ditahan, jadi request yang ditolak tidak menagih apa pun.
| Gejala | Penyebab | Solusi |
|---|---|---|
| Berhasil di Playground, gagal di kode | Biasanya base URL atau header di kodemu berbeda dari yang diuji. Pastikan mode Playground-nya cocok: chat di mode Chat, rute media di mode Media. | cetak URL akhir dan header yang benar-benar terkirim; bandingkan dengan halaman ini |
| Gagal di Playground dan di kode | Masalahnya di akun, saldo, atau key, bukan di kode. | periksa saldo, batas key, dan status key di konsol |
| Kadang berhasil, kadang 429 | Klienmu mengirim request lebih cepat atau lebih paralel daripada yang diizinkan. | ikuti retry-after dan batasi paralelisme; lihat Batas laju |
| Saldo tidak bertambah setelah membayar | Konfirmasi dari penyedia belum diterima, atau tidak lolos pemeriksaan. | tunggu sebentar dan muat ulang Transaksi; kalau tetap kosong, laporkan dengan referensinya |
422 capabilities_not_declared | Model itu belum mendeklarasikan kapabilitas yang diminta rute. capabilities-nya kosong, atau flag yang dibutuhkan tidak ada di dalamnya; platform tidak menebaknya dari nama model. | pilih model yang mendeklarasikannya, lalu cek capabilities di katalog publik atau di GET /v1/models. Kalau model itu seharusnya bisa, laporkan ke operator agar deklarasinya dilengkapi |
422 capability_mismatch | Model itu menyatakan tidak mendukung jenis permintaan ini: flag yang diminta rute bernilai false. | pakai model lain untuk rute itu. Rincian tiap rute ada di Gambar dan Audio |
501 surface_not_served | Model itu ada di katalog, tapi tidak dilayani lewat jalur media di deployment ini. Ini bukan gangguan, dan request-mu bukan penyebabnya. | pakai model yang dilayani untuk rute itu. Chat bukan penggantinya: rute chat tidak menghasilkan gambar atau audio. Kalau yang kamu butuhkan memang chat, jalurnya POST /v1/chat/completions atau POST /v1/messages |