Pemecahan masalah

Di halaman ini

Ikuti langkah untuk gejala yang sesuai dengan yang Anda lihat. Dalam hampir semua kasus, tab Logs adalah cara diagnosis tercepat — tab ini menampilkan status setiap permintaan dan pola kegagalannya (satu kunci? satu model? semuanya?). Lihat Aktivitas & log.

Permintaan diblokir

Setiap permintaan gagal dengan 402 `insufficient_credits`

Penyebab: modul belum diaktifkan untuk fasilitas ini, atau saldo prabayar telah habis (tab Overview akan menampilkan "Your balance is depleted. Inference requests will be blocked until you top up."). Untuk kunci API, fasilitas yang belum mengaktifkan Model Router akan mengembalikan 403 "Model Router is not enabled for this facility" sebagai gantinya.

Solusi: aktifkan Model Router dari halaman Welcome to Model Router (lihat Memulai), lalu isi ulang saldo di Budgets & Limits → Balance & Top-up. Permintaan akan berjalan kembali beberapa saat setelah saldo dikreditkan. Untuk mencegahnya terulang, aktifkan isi ulang otomatis. Lihat Anggaran & isi ulang.

Permintaan gagal dengan 402 `budget_exceeded`

Penyebab: batas pengeluaran telah tercapai. Pesan error menyebutkan periodenya (harian / bulanan / seumur hidup) dan — untuk harian dan bulanan — kapan tepatnya batas tersebut diatur ulang menurut zona waktu fasilitas Anda. Batas ini bisa berupa batas untuk seluruh akun atau batas pada kunci atau layanan terhubung tertentu (pesan menyebutkan "This key's" / "This agent's" jika batasnya berlaku untuk lingkup tersebut).

Solusi: tunggu hingga waktu pengaturan ulang yang disebutkan, naikkan batasnya (Budgets & Limits → Spend Limits, atau konfigurasi kunci atau layanan tersebut), atau — untuk batas maksimum seumur hidup — gunakan Reset hard cap. Halaman Spend Limits menunjukkan dengan tepat batas mana yang berstatus "Limit reached".

Permintaan gagal dengan 403 `content_policy_violation`

Penyebab: prompt cocok dengan filter konten dalam mode block atau dengan pelindung injeksi prompt.

Solusi: tinjau Settings → Guardrails. Jika satu integrasi memang memerlukan aturan yang berbeda, gunakan sakelar Override facility guardrails miliknya alih-alih melonggarkan kebijakan untuk seluruh fasilitas. Lihat Guardrails.

Permintaan gagal dengan 429

Penyebab: kunci atau layanan terhubung melampaui batas laju Requests / min atau Tokens / min.

Solusi: tunda sejenak lalu coba lagi, atau naikkan batas laju di konfigurasi kunci atau layanan (kosong = tanpa batas). Lihat Kunci API.

Model tertentu mengembalikan error, sedangkan model lain berfungsi

Penyebab: model tersebut mungkin dinonaktifkan untuk fasilitas Anda, dikecualikan oleh pembatasan model pada kunci, atau penyedianya sedang mengalami masalah.

Solusi: periksa Settings → Models (apakah model tersebut aktif?), daftar Restrict models pada kunci, dan Activity → Performance → Reliability & performance by model untuk melihat tingkat error model tersebut dari waktu ke waktu.

Masalah kunci API

401 Unauthorized

Penyebab: dengan kode invalid_api_key ("Missing or invalid API key"), header Authorization: Bearer … tidak ada atau formatnya salah. Tanpa kode ("Invalid API key"), kunci tidak dikenali (salah ketik, atau secret lama setelah rotate) atau sudah revoked.

Solusi: pastikan format header sudah benar; periksa status kunci di Settings → Service Access & API Keys. Aktifkan kembali kunci yang dicabut, atau perbarui layanan Anda dengan secret baru jika kunci telah dirotasi.

Saya kehilangan secret kunci

Secret hanya ditampilkan sekali saat dibuat dan tidak dapat dipulihkan. Gunakan Rotate — secret baru akan diterbitkan (ditampilkan sekali) dan kunci tetap mempertahankan label, batas, dan riwayatnya. Perbarui setiap layanan yang menggunakan kunci tersebut: "You will need to reconfigure any services still using the old key."

Kunci berfungsi, tetapi penggunaannya muncul dengan nama yang salah

Kunci diidentifikasi berdasarkan Label-nya di Activity dan Logs. Edit kunci dan tetapkan label yang bermakna; berikan setiap sistem kuncinya sendiri alih-alih menggunakan satu kunci bersama.

Masalah agen

Agen menampilkan status Offline

Penyebab: perangkat dimatikan atau tidak memiliki konektivitas — ini masalah konektivitas perangkat, bukan pengaturan Model Router.

Solusi: periksa daya dan jaringan perangkat. Konfigurasi aksesnya tidak terpengaruh dan akan berfungsi kembali begitu perangkat terhubung lagi.

Agen berhenti merespons permintaan AI

Periksa, secara berurutan:

Saldo — saldo yang habis memblokir semua agen (agen menampilkan status perlu kredit). Isi ulang saldo.
Batas per layanan — Settings → Service Access & API Keys → Connected Services: apakah agen menampilkan "Limit reached"? Naikkan batasnya atau tunggu hingga batas diatur ulang.
Batas akun — Budgets & Limits → Spend Limits.
Log — filter berdasarkan agen untuk melihat error sebenarnya pada permintaannya.

Pertanyaan saldo & penagihan

Angka pengeluaran tampak tertinggal

Angka Available balance dan Spent today bersifat langsung. Monthly usage direkonsiliasi dengan saldo Anda setiap 15 menit, sehingga pengeluaran yang sangat baru bisa memerlukan beberapa menit untuk muncul di sana. Riwayat transaksi hanya mencantumkan isi ulang dan penyesuaian saldo, sehingga penggunaan tidak pernah muncul di dalamnya.

Isi ulang otomatis tidak berjalan

Periksa apakah ada banner di halaman Balance & Top-up: tidak ada kartu tersimpan, kartu memerlukan autentikasi, atau kartu ditolak. Perbaiki kartu (Update card / Edit payment details) atau isi ulang secara manual. Pemeriksaan isi ulang otomatis berjalan kira-kira setiap 15 menit, sehingga ambang batas yang baru saja terlewati bisa memerlukan beberapa menit untuk memicunya.

Isi ulang gagal

"Additional card authentication is required. Please try again." — coba lagi; bank Anda mungkin meminta verifikasi. "Top-up could not be completed." — tagihan ditolak; periksa kartu atau coba jumlah lain. Tidak ada kredit yang ditambahkan kecuali tagihan berhasil.

Saya ditagih, tetapi saldo tidak berubah

Isi ulang langsung dikreditkan — muat ulang halaman. Jika saldo masih belum mencerminkan tagihan yang berhasil, catat Transaction ID dan Payment reference dari panel detail transaksi (atau laporan kartu Anda) lalu ajukan permintaan dukungan.

Pertanyaan log & analitik

Permintaan yang baru saja saya buat belum muncul di Logs

Aktifkan penyegaran Live (atau klik Refresh now). Permintaan biasanya muncul dalam beberapa saat; saat beban tinggi, prosesnya bisa sedikit lebih lama.

Log menampilkan model yang tidak saya minta

Jika Anda mengirim model: "auto", log menampilkan model yang dipilih oleh Auto Router — buka detail permintaan untuk melihat Requested model: auto. Ini memang perilaku yang diharapkan. Lihat Model.

Baris menampilkan "No charge"

Respons yang gagal atau kosong dan tidak dikenai biaya diberi lencana No charge — respons tersebut dicatat demi kelengkapan, tetapi tidak mengurangi saldo.

Ekspor CSV saya lebih kecil dari yang diharapkan

Ekspor mentah dibatasi hingga 25,000 baris — persempit rentang tanggal atau gunakan ekspor ringkasan. Perhatikan juga: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."