Kesalahan umum dan pemecahan masalah akses
401 / invalid_api_key
Pastikan permintaan dikirim ke Base URL situs ini dan Authorization menggunakan Bearer sk-.... Periksa apakah kunci sudah lengkap, belum dicabut, dan terhubung ke grup yang benar.
404 / model tidak ditemukan
Periksa ID model, alamat protokol, dan grup kunci secara berurutan. OpenAI Compatible biasanya menggunakan alamat dengan /v1; Claude Code biasanya menggunakan alamat dasar tanpa /v1.
403 atau pemblokiran pengendalian risiko
Tetapkan User-Agent yang jelas pada skrip agar gateway tidak memblokir permintaan karena User-Agent kosong. Jangan mencoba melewati pembatasan dengan mengulang permintaan terus-menerus.
Permintaan lambat
Uji terlebih dahulu dengan pertanyaan singkat. Jika pertanyaan singkat cepat tetapi tugas kompleks lambat, penyebabnya biasanya panjang konteks atau waktu inferensi model. Jika pertanyaan singkat juga lambat, periksa jaringan lokal, koneksi, dan status layanan.
Terhubung tetapi klien tidak berubah
Tutup klien sepenuhnya, lalu buka kembali. Periksa apakah ada beberapa file konfigurasi, variabel lingkungan lama yang menimpa konfigurasi baru, atau penyedia tujuan yang belum benar-benar diaktifkan di CC Switch.
Daftar periksa sebelum digunakan
- Verifikasi kunci, Base URL, dan model dengan permintaan minimal.
- Tetapkan batas waktu, percobaan ulang, konkurensi, dan anggaran.
- Siapkan koneksi atau model cadangan.
- Samarkan informasi sensitif dalam log; jangan mencatat kunci lengkap.