Lewati ke isi dokumentasi
Bantuan

Bantuan

Mendiagnosis sendiri, dan apa yang perlu disertakan saat melapor.

Bantuan5 bagianAPI v1
Di halaman ini5 bagian

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.menvorainterasia.com/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. Untuk rute media, periksa juga capabilities-nya: model yang tidak mendeklarasikan kemampuan yang diminta rute akan ditolak sebelum request dijalankan.
  3. 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.
  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.

cara cepat melihat code
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, 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 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.

GejalaPenyebabSolusi
Berhasil di Playground, gagal di kodeBiasanya 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 kodeMasalahnya di akun, saldo, atau key, bukan di kode.periksa saldo, batas key, dan status key di konsol
Kadang berhasil, kadang 429Klienmu mengirim request lebih cepat atau lebih paralel daripada yang diizinkan.ikuti retry-after dan batasi paralelisme; lihat Batas laju
Saldo tidak bertambah setelah membayarKonfirmasi dari penyedia belum diterima, atau tidak lolos pemeriksaan.tunggu sebentar dan muat ulang Transaksi; kalau tetap kosong, laporkan dengan referensinya
422 capabilities_not_declaredModel 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_mismatchModel 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_servedModel 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