Penyelesaian masalah

Pada halaman ini

Ikuti simptom yang sepadan dengan perkara yang anda lihat. Dalam hampir setiap kes, tab Logs ialah cara diagnostik terpantas — tab ini menunjukkan status setiap permintaan dan corak kegagalan (satu kunci? satu model? semuanya?). Lihat Aktiviti & log.

Permintaan disekat

Setiap permintaan gagal dengan 402 `insufficient_credits`

Punca: modul tidak didayakan untuk kemudahan ini, atau baki prabayar telah habis (tab Overview akan menunjukkan "Your balance is depleted. Inference requests will be blocked until you top up."). Bagi kunci API, kemudahan yang tidak mendayakan Model Router sebaliknya mengembalikan 403 "Model Router is not enabled for this facility".

Pembetulan: dayakan Model Router dari halaman Welcome to Model Router (lihat Bermula), kemudian tambah nilai di bawah Budgets & Limits → Balance & Top-up. Permintaan disambung semula sejurus selepas baki dikreditkan. Untuk mengelakkannya berulang, dayakan tambah nilai automatik. Lihat Belanjawan & tambah nilai.

Permintaan gagal dengan 402 `budget_exceeded`

Punca: had perbelanjaan telah dicapai. Mesej ralat menyatakan tetingkap yang berkenaan (harian / bulanan / sepanjang hayat) dan — bagi harian dan bulanan — masa tepat ia ditetapkan semula dalam zon waktu kemudahan anda. Ia mungkin had seluruh akaun atau had pada kunci atau perkhidmatan bersambung tertentu (mesej menyebut "This key's" / "This agent's" apabila berskop).

Pembetulan: sama ada tunggu penetapan semula yang dinyatakan, naikkan had (Budgets & Limits → Spend Limits, atau konfigurasi kunci atau perkhidmatan), atau — bagi had mutlak sepanjang hayat — gunakan Reset hard cap. Halaman Spend Limits menunjukkan dengan tepat had yang berada pada "Limit reached".

Permintaan gagal dengan 403 `content_policy_violation`

Punca: gesaan sepadan dengan penapis kandungan mod block atau perisai suntikan gesaan.

Pembetulan: semak Settings → Guardrails. Jika satu integrasi benar-benar memerlukan peraturan yang berbeza, gunakan togol Override facility guardrails integrasi tersebut dan bukannya melonggarkan dasar seluruh kemudahan. Lihat Guardrails.

Permintaan gagal dengan 429

Punca: kunci atau perkhidmatan bersambung telah melebihi had kadar Requests / min atau Tokens / min.

Pembetulan: tunggu sebentar dan cuba semula, atau naikkan had kadar dalam konfigurasi kunci atau perkhidmatan (kosong = tanpa had). Lihat Kunci API.

Model tertentu mengembalikan ralat, model lain berfungsi

Punca: model itu mungkin dinyahdayakan untuk kemudahan anda, dikecualikan oleh sekatan model kunci, atau penyedia mungkin sedang mengalami masalah.

Pembetulan: semak Settings → Models (adakah ia didayakan?), senarai Restrict models kunci, dan Activity → Performance → Reliability & performance by model untuk kadar ralat model dari semasa ke semasa.

Masalah kunci API

401 Unauthorized

Punca: dengan kod invalid_api_key ("Missing or invalid API key"), pengepala Authorization: Bearer … tiada atau salah format. Tanpa kod ("Invalid API key"), kunci tidak dikenali (salah taip, atau rahsia lama selepas rotate) atau telah revoked.

Pembetulan: sahkan format pengepala; semak status kunci dalam Settings → Service Access & API Keys. Aktifkan semula kunci yang telah dibatalkan, atau kemas kini perkhidmatan anda kepada rahsia baharu jika kunci telah diputar.

Saya kehilangan rahsia kunci

Rahsia hanya ditunjukkan sekali semasa penciptaan dan tidak boleh dipulihkan. Gunakan Rotate — rahsia baharu dikeluarkan (ditunjukkan sekali) dan kunci mengekalkan label, had dan sejarahnya. Kemas kini setiap perkhidmatan yang menggunakan kunci tersebut: "You will need to reconfigure any services still using the old key."

Kunci berfungsi tetapi penggunaan dipaparkan di bawah nama yang salah

Kunci dikenal pasti melalui Label masing-masing dalam Activity dan Logs. Edit kunci dan tetapkan label yang bermakna; berikan setiap sistem kuncinya sendiri dan bukannya berkongsi satu kunci.

Masalah ejen

Ejen menunjukkan Offline

Punca: peranti dimatikan atau tiada kesambungan — ini ialah kesambungan peranti, bukan tetapan Model Router.

Pembetulan: semak kuasa dan rangkaian peranti. Konfigurasi aksesnya tidak terjejas dan berfungsi semula sebaik sahaja ia bersambung semula.

Ejen berhenti membalas permintaan AI

Semak, mengikut urutan:

Baki — baki yang habis menyekat semua ejen (ejen menunjukkan keadaan memerlukan kredit). Tambah nilai.
Had setiap perkhidmatan — Settings → Service Access & API Keys → Connected Services: adakah ejen menunjukkan "Limit reached"? Naikkan had atau tunggu sehingga had ditetapkan semula.
Had akaun — Budgets & Limits → Spend Limits.
Logs — tapis mengikut ejen untuk melihat ralat sebenar pada permintaannya.

Soalan tentang baki & pengebilan

Angka perbelanjaan kelihatan ketinggalan

Angka Available balance dan Spent today adalah langsung. Monthly usage disesuaikan dengan baki anda setiap 15 minit, jadi perbelanjaan yang sangat baharu mungkin mengambil masa beberapa minit untuk dipaparkan di sana. Sejarah transaksi hanya menyenaraikan tambah nilai dan pelarasan baki, jadi penggunaan tidak pernah dipaparkan di dalamnya.

Tambah nilai automatik tidak berjalan

Semak halaman Balance & Top-up untuk sepanduk: tiada kad dalam fail, kad memerlukan pengesahan, atau kad ditolak. Betulkan kad (Update card / Edit payment details) atau tambah nilai secara manual. Semakan tambah nilai automatik berjalan lebih kurang setiap 15 minit, jadi ambang yang baru dilepasi mungkin mengambil masa beberapa minit untuk mencetuskannya.

Tambah nilai gagal

"Additional card authentication is required. Please try again." — cuba semula; bank anda mungkin meminta pengesahan. "Top-up could not be completed." — caj telah ditolak; semak kad atau cuba amaun lain. Tiada kredit diberikan melainkan caj berjaya.

Saya telah dicaj tetapi baki tidak berubah

Tambah nilai dikreditkan serta-merta — muat semula halaman. Jika baki masih tidak mencerminkan caj yang berjaya, catatkan Transaction ID dan Payment reference daripada laci butiran transaksi (atau penyata kad anda) dan ajukan permintaan sokongan.

Soalan tentang log & analitik

Permintaan yang baru saya buat belum ada dalam Logs

Hidupkan muat semula Live (atau klik Refresh now). Permintaan biasanya dipaparkan dalam beberapa saat; apabila beban tinggi ia mungkin mengambil masa lebih sedikit.

Logs menunjukkan model yang tidak saya minta

Jika anda menghantar model: "auto", log menunjukkan model yang dipilih oleh Auto Router — buka butiran permintaan untuk melihat Requested model: auto. Ini dijangkakan. Lihat Model.

Baris menunjukkan "No charge"

Respons yang gagal atau kosong yang tidak dikenakan kos ditandakan dengan lencana No charge — ia direkodkan untuk kelengkapan tetapi tidak menggunakan baki.

Eksport CSV saya lebih kecil daripada yang dijangkakan

Eksport mentah dihadkan kepada 25,000 baris — kecilkan julat tarikh atau gunakan eksport ringkasan. Perhatikan juga: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."