PandaNpc menyimpan koneksi penyedia dan entri model yang Anda konfigurasikan. Mulailah dengan Kunci API, URL Dasar, protokol, dan ID model yang disediakan oleh layanan Anda. Menambahkan entri tidak membuat akun hulu atau memberikan akses model.
Untuk perbedaan antara penyedia dan model, baca Kelola daftar model kustom Anda.
Sebelum memulai
Konfirmasikan hal berikut dengan penyedia atau layanan yang dihosting sendiri:
- Alamat dasar API, bukan alamat situs web penyedia.
- Metode autentikasi dan kredensial yang diperlukan.
- Protokol API yang didukung oleh fitur atau mesin yang ingin Anda gunakan.
- ID model yang tepat yang dapat dipanggil oleh akun Anda.
- Batas konteks dan keluaran jika Anda berencana memasukkannya secara manual.
Simpan kredensial di formulir penyedia, bukan di perintah, tangkapan layar, atau catatan bersama. Layanan yang diiklankan kompatibel dengan OpenAI mungkin masih berbeda dalam streaming, panggilan alat, atau dukungan gambar.
1. Tambahkan atau konfigurasikan penyedia
Buka Konfigurasi Model. Tambahkan penyedia, konfigurasikan prasetel yang ada, atau salin prasetel saat Anda memerlukan koneksi yang dapat diedit secara independen.
| Bidang | Apa yang harus diisi |
|---|---|
| Nama Tampilan | Nama yang mudah dikenali untuk koneksi ini |
| ID Penyedia | Pengidentifikasi untuk konfigurasi penyedia |
| Kunci API | Kredensial yang diperlukan oleh layanan Anda |
| URL Dasar | Alamat dasar API yang diharapkan oleh integrasi yang dipilih |
| Protokol | Format yang benar-benar diterapkan oleh API hulu |
| Rahasia, Organisasi, Proyek | Hanya nilai yang secara eksplisit diperlukan oleh layanan Anda |
| Dukungan array konten | Apakah layanan menerima konten pesan terstruktur |
Bentuk URL Dasar tergantung pada protokol dan fitur yang membuat permintaan. Jangan menambahkan jalur operasi lengkap jika integrasi sudah menambahkannya. Misalnya, integrasi yang menambahkan /chat/completions memerlukan alamat dasar yang sesuai, bukan alamat yang sudah diakhiri dengan jalur tersebut. Jangan menerapkan contoh itu ke setiap protokol.
Saat mengedit kredensial yang tersimpan, membiarkan Kunci API atau Rahasia kosong akan mempertahankan nilai yang dikonfigurasi. Nilai yang disembunyikan yang ditampilkan dalam daftar bukan kunci asli dan tidak boleh ditempel kembali sebagai pengganti.
2. Tambahkan model
Simpan penyedia, pilih, dan pilih Tambahkan Model.
| Bidang | Arti |
|---|---|
| Nama Tampilan | Label Anda di daftar model |
| Nilai Model | ID model hulu yang tepat |
| Tipe Model | Kategori yang berlaku dalam formulir konfigurasi |
| Penyedia | Koneksi yang digunakan entri ini |
| Jendela Konteks | Kapasitas konteks yang terdokumentasi, jika ditentukan |
| Token Maksimum | Batas keluaran, jika ditentukan |
Gunakan ID dari dokumentasi layanan atau daftar model. Nama pemasaran belum tentu merupakan pengidentifikasi API. Biarkan batas opsional tidak disetel jika Anda tidak dapat memverifikasinya; tidak disetel tidak berarti batas sebenarnya telah terdeteksi. Fitur yang menggunakan mungkin menerapkan defaultnya sendiri.
3. Verifikasi konfigurasi
Di fitur atau mesin yang menggunakan pengaturan ini:
- Pilih entri baru dan mulai percakapan uji.
- Kirim permintaan pendek seperti
Balas dengan: terhubung. - Konfirmasikan respons normal dan, jika tersedia, permintaan yang cocok dalam catatan penggunaan penyedia.
- Kirim tindak lanjut untuk memeriksa percakapan berkelanjutan.
- Uji gambar atau panggilan alat secara terpisah jika pekerjaan Anda memerlukannya.
Menyimpan catatan bukanlah uji koneksi. Respons teks tidak menetapkan kompatibilitas dengan setiap kemampuan. Mengubah entri model juga tidak secara otomatis mengonfigurasi ulang proses Claude Code atau Codex yang ada; lihat PandaPaw.
Pemecahan Masalah
Autentikasi gagal
Periksa apakah kunci aktif, akun dapat mengakses model, dan layanan memerlukan bidang autentikasi tambahan. Ganti kredensial yang kedaluwarsa melalui formulir penyedia.
Titik akhir atau model tidak ditemukan
Periksa URL Dasar dan Nilai Model. Cari jalur operasi duplikat, awalan API yang hilang, atau ID model yang tidak tersedia untuk akun Anda. Kesalahan yang sama dapat memiliki penyebab berbeda di berbagai penyedia.
Muncul kesalahan jaringan atau browser
Periksa konektivitas dari perangkat yang benar-benar mengirim permintaan. Permintaan yang berasal dari browser tunduk pada batasan CORS dan HTTPS; permintaan yang berhasil dari komputer lain tidak membuktikan bahwa jalur browser berfungsi.
Server model lokal tidak dapat dijangkau
localhost mengacu pada mesin yang membuat permintaan. Ini tidak secara otomatis menunjuk ke komputer PandaPaw jarak jauh Anda. Konfirmasikan di mana fitur yang menggunakan berjalan sebelum memilih alamat server lokal Anda.
Teks berfungsi tetapi gambar, alat, atau sesi panjang gagal
Periksa kombinasi persis mesin, protokol API, dan kemampuan model. Gunakan batas yang didukung penyedia dan verifikasi setiap jenis masukan yang diperlukan. Meningkatkan Jendela Konteks atau mengubah Tipe Model tidak menambahkan kemampuan hulu.
Untuk perbedaan antara keanggotaan platform dan penggunaan penyedia, lihat akun dan biaya model.