Menghubungkan GPT dan API pihak ketiga di Cherry Studio
Pilih protokol yang tepat, masukkan URL root penyedia, tambahkan ID model yang tepat, dan verifikasi satu permintaan kecil sebelum memperluas penyiapan.
Mencari cara menghubungkan GPT ke Cherry Studio biasanya berarti Anda memerlukan konfigurasi penyedia yang berfungsi, bukan tur fitur. Bidang penting adalah protokol, kunci API, URL dasar, dan ID model pasti.
Jalan singkatnya adalah:
Pengaturan → Layanan Model → pilih atau tambahkan penyedia → masukkan kredensial dan URL API → ambil atau tambahkan model → aktifkan penyedia → jalankan pemeriksaan kesehatan.
Cherry Studio memiliki penyedia bawaan untuk layanan seperti OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot, Ollama, dan LM Studio. Gateway atau layanan yang dihosting sendiri dapat ditambahkan melalui penyedia kustom ketika layanan tersebut mengekspos titik akhir yang kompatibel dengan OpenAI, Anthropic, atau Gemini. Lihat panduan pengaturan penyedia resmi untuk nama UI saat ini.
Apa yang Anda butuhkan sebelum membuka Cherry Studio
Siapkan empat nilai dari layanan yang ingin Anda gunakan:
| Nilai | Apa artinya |
|---|---|
| Protokol | Kompatibel dengan OpenAI, Pesan Anthropic, Gemini, atau format terdokumentasi penyedia |
| Kunci API | Kredensial yang digunakan untuk mengautentikasi permintaan |
| Base URL | Alamat root API, kecuali penyedia secara eksplisit memerlukan titik akhir penuh |
| Model ID | String persisnya diterima oleh API upstream |
Jangan gunakan kata sandi obrolan web sebagai kunci API. Langganan ChatGPT, akun API, dan gateway pihak ketiga merupakan jalur akses terpisah. Gunakan kredensial dan titik akhir yang didokumentasikan oleh layanan yang Anda pilih.
Hubungkan GPT dalam lima langkah
Layanan Model Terbuka 1.
Mulai Cherry Studio dan buka Pengaturan → Layanan Model. Pilih penyedia OpenAI bawaan saat Anda menelepon OpenAI secara langsung. Untuk gateway, agregator, atau penerapan privat, pilih Tambahkan penyedia dan buat entri kustom terpisah.
Penyedia dipilih berdasarkan protokolnya, bukan berdasarkan kata GPT di nama modelnya. Model berlabel GPT di belakang gateway yang kompatibel dengan Anthropic masih memerlukan profil protokol Anthropic.
2. Isi kolom penyedia
Gunakan dokumentasi penyedia untuk setiap bidang:
| bidang Cherry Studio | Apa yang harus dimasukkan | Hindari |
|---|---|---|
| Nama penyedia | Label yang akan Anda kenali nanti | Menggunakan kembali satu label untuk titik akhir yang tidak terkait |
| Kunci API | Nilai kuncinya saja | Spasi ekstra, tanda kutip, atau Bearer |
| Tipe API | Protokol yang sebenarnya diterapkan oleh titik akhir | Menebak dari nama pemasaran modelnya |
| Alamat API | URL root yang terdokumentasi atau URL lengkap yang diperlukan | URL dasbor atau jalur duplikat |
Untuk layanan konvensional yang kompatibel dengan OpenAI, Cherry Studio umumnya mengharapkan alamat root dan menambahkan versi serta jalur permintaan. Jika penyedia menampilkan https://api.example.com dan https://api.example.com/v1/chat/completions, yang pertama adalah URL dasar normal. Jangan tambahkan /v1 dua kali. Gunakan jalur lengkap hanya jika penyedia secara eksplisit mengatakan untuk melakukannya.
Panduan penyedia khusus mencakup titik akhir tambahan, entri model manual, dan layanan lokal bergaya vLLM.
3. Ambil atau tambahkan model
Klik Dapatkan daftar model. Jika titik akhir memperlihatkan penemuan model, tambahkan model dengan tombol +. ID yang dikembalikan bersifat otoritatif: pertahankan tanggal, awalan vendor, tanda hubung, dan akhiran versi persis seperti yang ditunjukkan.
Jika penyedia tidak menampilkan daftar model, tambahkan model secara manual. Penyimpanan penyedia yang berhasil tidak secara otomatis membuat model tersedia di alat pilih obrolan. Model harus ditambahkan dan saklar penyedia harus diaktifkan.
4. Centang satu permintaan singkat
Gunakan Periksa dengan model yang baru saja Anda tambahkan, lalu kirimkan perintah minimal:
Reply with exactly: connection successful
Hal ini memisahkan masalah autentikasi dan perutean dari masalah visi, alat, konteks panjang, atau kemampuan agen. Konfirmasikan panggilan di halaman penggunaan penyedia jika tersedia.
5. Tambahkan kemampuan tingkat lanjut satu per satu
Setelah teks biasa berfungsi, uji streaming, gambar, alat, atau parameter penalaran satu per satu. Respons obrolan yang berhasil hanya membuktikan bahwa rute teks dasar berfungsi; hal ini tidak membuktikan bahwa model atau protokol mendukung setiap fitur yang diekspos Cherry Studio.
Menghubungkan API pihak ketiga lainnya
Gateway yang kompatibel dengan OpenAI
Gunakan Penyedia khusus → OpenAI saat gateway mendokumentasikan OpenAI Chat Completions atau permukaan lain yang kompatibel dengan OpenAI. Ini adalah jalur biasa untuk agregator, gateway privat, vLLM, dan banyak model terbuka yang dihosting.
Gerbang multi-protokol
Gateway gaya API baru dapat mengekspos Obrolan OpenAI, Respons OpenAI, Pesan Anthropic, dan rute Gemini dari satu alamat root. Instruksi NewAPI Cherry Studio menjelaskan bahwa klien memilih jalur versi untuk protokol yang dipilih. Gunakan preset NewAPI ketika gateway mengikuti kontrak tersebut; gunakan penyedia khusus jika penyedia tersebut memiliki jalur terdokumentasi atau variasi penemuan model.
Ollama, LM Studio, dan vLLM
Pilih penyedia lokal yang cocok, atau gunakan penyedia OpenAI khusus ketika server lokal menampilkan API yang kompatibel dengan OpenAI. Masukkan nama model yang sebenarnya dimuat oleh server lokal. Eksekusi lokal dapat mengurangi paparan data, namun model lokal masih berbeda dalam hal visi, alat, panjang konteks, dan dukungan penalaran.
Ketika daftar model kosong
Lakukan pemeriksaan ini secara berurutan:
- Konfirmasikan bahwa layanan mengimplementasikan titik akhir daftar model. Beberapa API hanya menerima ID model yang diberikan secara manual.
- Hapus segmen jalur yang diduplikasi. URL root yang sudah berisi
/v1bisa gagal ketika Cherry Studio menambahkan/v1lainnya. - Periksa apakah Anda menggunakan alamat API, bukan alamat dasbor manajemen penyedia.
- Salin ID model persis yang dikembalikan oleh penyedia. Nama tampilan dan ID API tidak dapat dipertukarkan.
- Pastikan penyedia diaktifkan. Penyedia yang dinonaktifkan menyembunyikan modelnya dari pemilih.
Kesalahan umum
| Kesalahan | Kemungkinan penyebabnya | Periksa pertama |
|---|---|---|
401 Unauthorized | Kunci tidak valid, kedaluwarsa, atau formatnya salah | Salin ulang kunci dan konfirmasi profil protokol |
403 Forbidden | Akun, proyek, saldo, atau batas kunci | Periksa izin penyedia dan kuota |
404 Not Found | URL root salah, jalur versi duplikat, atau ketidakcocokan protokol | Pulihkan URL dasar yang terdokumentasi |
400 Bad Request | Parameter atau bentuk permintaan tidak didukung | Hapus parameter khusus dan coba lagi teks biasa |
model not found | ID atau model salah tidak ditambahkan di Cherry Studio | Salin ID model upstream yang tepat |
| Teks berfungsi tetapi gambar/alat gagal | Model atau protokol tidak memiliki kemampuan itu | Periksa daftar kemampuan dan rute |
| Batas waktu | Latensi penyedia, masalah jaringan, atau permintaan yang terlalu besar | Coba lagi dengan perintah singkat dan satu model |
Ubah satu variabel pada satu waktu. Mulailah dengan satu penyedia, satu model, dan satu permintaan singkat; baru kemudian tambahkan beberapa model atau alat.
Membandingkan beberapa model
Cherry Studio memungkinkan Anda berpindah model di pemilih percakapan dan mengirimkan perintah yang sama ke beberapa model yang dipilih. Setiap pilihan menciptakan permintaan independen. Hal ini berguna untuk perbandingan, namun hal ini bukan merupakan pemungutan suara otomatis atau jaminan kualitas; jumlah permintaan, biaya, dan paparan data meningkat dengan setiap model yang dipilih. panduan perbandingan resmi merekomendasikan untuk menulis kriteria evaluasi yang eksplisit daripada menanyakan jawaban mana yang “terbaik”.
Gunakan OmniaKey sebagai salah satu penyedia
Jika Anda tidak ingin mempertahankan titik masuk terpisah untuk GPT, Claude, Gemini, dan model lainnya, konfigurasikan OmniaKey sebagai penyedia khusus yang kompatibel dengan OpenAI di Cherry Studio.
- Buat kunci OmniaKey API khusus dan tetapkan batas kunci yang sesuai di halaman Kunci API.
- Buka Pengaturan → Layanan Model → Tambahkan penyedia di Cherry Studio.
- Pilih jenis yang kompatibel dengan OpenAI dan masukkan URL dasar serta kunci dari mulai cepat OmniaKey.
- Ambil daftar model, atau tambahkan ID persisnya dari katalog model langsung.
- Aktifkan penyedia, jalankan pemeriksaan singkat, dan konfirmasikan permintaan di Penggunaan.
Katalog OmniaKey saat ini mencakup Claude, GPT, Gemini, dan Grok, bersama dengan rangkaian model tambahan. ID dan kemampuan bersifat dinamis, jadi gunakan katalog langsung daripada tutorial lama. Rute yang kompatibel dengan OpenAI tidak membuat setiap fitur khusus penyedia menjadi identik; periksa model dan kemampuan protokol sebelum mengaktifkan visi atau alat.
Pertanyaan Umum
Bisakah Cherry Studio menggunakan API yang saya temukan?
Hanya ketika layanan mengekspos protokol yang didukung Cherry Studio. URL arbitrer tanpa format permintaan, metode autentikasi, dan ID model yang terdokumentasi tidaklah cukup.
Haruskah saya memasukkan URL root atau /chat/completions?
Ikuti dokumentasi penyedia. Penyedia konvensional biasanya menggunakan URL root dan membiarkan Cherry Studio menambahkan jalur permintaan; gunakan titik akhir penuh hanya ketika penyedia secara eksplisit memerlukannya.
Mengapa saya bisa ngobrol tetapi tidak menggunakan alat atau gambar?
Keberhasilan teks dasar tidak membuktikan bahwa model, protokol, dan alat atau visi dukungan rute klien yang dipilih. Periksa setiap kemampuan secara terpisah.
Apakah langganan web ChatGPT merupakan kunci API?
Tidak. Cherry Studio memerlukan kredensial penyedia API atau kredensial gateway yang kompatibel. Detail login web tidak boleh ditempelkan ke kolom kunci API.
Sumber dan kesegaran
Panduan ini menggunakanCherry Studiopenyedia saat ini, penyedia khusus,OpenAI, NewAPI, dan dokumentasi multi-model, plusOmniaKeysaat iniAPIdan dokumentasi model. Nilai teknis seperti ID model, kemampuan penyedia, dan rute dapat berubah; verifikasi mereka pada saat konfigurasi.