Kapan memakai penyedia sendiri
Deskgram dapat menghubungkan layanan AI dengan API yang kompatibel dan menyediakan modelnya pada modul pendukung AI. Siapkan alamat dasar API, kunci dan ID model yang tepat. Nama penyedia di formulir hanyalah label, bukan bukti kompatibilitas.
Implementasi memakai /models untuk daftar model dan /chat/completions untuk pembuatan teks. Layanan dapat memerlukan autentikasi, format respons atau parameter tambahan yang berbeda. Label “OpenAI-compatible” saja tidak menjamin dapat digunakan.
Siapkan akses API
Baca dokumentasi penyedia, buat kunci dengan izin yang diperlukan, lalu periksa biaya, model dan batas pemakaian. Langganan chat di browser belum tentu mencakup API.
https://provider.example/v1 adalah contoh akar API, bukan layanan nyata. Jangan menempelkan endpoint lengkap /chat/completions ke Base URL karena Deskgram menambahkan jalur operasi. Gunakan akar serta versi yang didokumentasikan penyedia.
Jangan membagikan kunci di pesan dukungan atau tangkapan layar. Jika bocor, cabut melalui panel penyedia dan ganti di program.
Tambahkan koneksi dan model
- Buka Pengaturan → API → penyedia sendiri, lalu formulir tambah.
- Isi nama yang mudah dikenali.
- Lengkapi Base URL dan API Key.
- Tambahkan setidaknya satu model. ID harus merupakan pengenal teknis tepat; nama tampilan opsional tidak menggantikannya dalam permintaan.
- Untuk beberapa model, tandai model default dengan bintang. Model pertama awalnya menjadi default; periksa sebelum menyimpan.
- Aktifkan dukungan saldo hanya jika koneksi memang mendukung pemeriksaannya. Kotak centang itu tidak menciptakan API saldo universal.
Apa yang diperiksa Test
Test pertama-tama mencoba mengambil daftar model. Anda dapat menambahkan model yang ditemukan satu per satu atau semuanya, lalu memeriksa ID dan default. Daftar yang berhasil diambil belum membuktikan izin generasi setiap model.
Jika daftar tidak tersedia tetapi model default diisi manual, pengujian dapat mengirim permintaan generasi singkat. Permintaan ini memakai kuota dan mungkin dikenai biaya. Jika ID belum diketahui, cari di dokumentasi, tambahkan manual dan uji lagi.
Setelah verifikasi, simpan. Diperlukan nama, URL, kunci dan setidaknya satu ID model. Kemudian pilih penyedia serta model dalam modul AI yang dituju.
Uji generasi singkat secara terpisah: bahasa, format dan tidak adanya teks kesalahan. Gunakan pratinjau modul jika tersedia. Jika tidak, uji dahulu model di konsol API penyedia, kemudian lakukan proses kecil dengan data uji sendiri. Jangan mengirim hasil percobaan kepada penerima lain. Pemeriksaan ini berbeda dari mengambil daftar model.
Kesalahan, biaya dan fallback
Periksa akar dan versi API, kunci, izin model, ID tepat, kuota serta respons dalam log. Mengubah nama tampilan tidak memperbaiki ID yang salah. Permintaan berulang tidak menggantikan isi ulang saldo atau penyesuaian batas.
Beberapa model dalam kartu memungkinkan pemilihan, bukan jaminan perpindahan otomatis ke semua model atau penyedia sendiri saat gagal. Penyedia bawaan memiliki logika fallback terpisah yang tidak berlaku otomatis untuk semua koneksi.
Harga, kuota gratis dan batas ditentukan penyedia API. Harga nol atau tidak ditampilkan bukan berarti generasi gratis. Ini juga berlaku untuk Mistral: periksa akses, biaya dan batas terkini. Satu pengujian berhasil tidak menjamin respons berikutnya selalu bebas kesalahan.
Tangkapan layar antarmuka
Gambar memakai antarmuka Rusia. Tata letak bisa berbeda; ikuti bidang yang dijelaskan di atas. Gambar lama mungkin belum menunjukkan pengaturan beberapa model dan default.
