Cherry Studio + JoinGonka Gateway — klien AI desktop

Instalasi. Build untuk semua sistem tersedia di halaman rilis proyek: installer dan versi portabel untuk Windows, image dmg untuk macOS, AppImage, deb, dan rpm untuk Linux — untuk x64 dan ARM. Riwayat percakapan dan pengaturan disimpan secara lokal, di komputer Anda.

V1 atau V2. Pada Agustus 2026 hadir lini V2 dengan struktur data baru dan pengaturan yang dirombak; build terakhir lini sebelumnya adalah 1.9.13. Penyedia kustom tersedia di keduanya, hanya berbeda pada bentuk penambahannya dan sebagian label — tempat-tempat seperti itu ditandai di bawah ini. Saat beralih dari V1, pengaturan penyedia dan model dipindahkan secara otomatis, data asli V1 tetap disimpan, tetapi data baru tidak tersinkronisasi balik, dan cadangan dari kedua lini tidak kompatibel. Sebelum memperbarui, baca bagian tentang migrasi di dokumentasi Cherry Studio.

Kunci JoinGonka. Daftar di gateway, buka bagian « API keys » di dashboard dan klik « Buat kunci ». Kunci diawali dengan jg- dan hanya ditampilkan sekali — simpan segera. Sebaiknya buat kunci terpisah khusus untuk Cherry Studio: di bagian « Penggunaan », konsumsinya akan terlihat di baris tersendiri.

1. Klik ikon roda gigi — pengaturan akan terbuka. Pilih bagian Model Provider (di dokumentasi bahasa Inggris disebut Model Services).
2. Di bawah daftar penyedia, klik Add Provider.
3. Di V2, dialog Add Custom Provider akan terbuka. Isi Provider Name — misalnya JoinGonka. Di blok Endpoint settings, isi baris OpenAI dengan alamat https://gate.joingonka.ai/v1: di bawah kolom akan muncul baris Request path dengan jalur akhirnya — jalur itu harus berakhir dengan /v1/chat/completions. Di kolom API Key, tempelkan jg-your-key lalu klik Add.
4. Di V1, dialognya lebih singkat: nama penyedia dan Provider Type — pilih OpenAI. Kunci dan alamat dimasukkan langsung di halaman penyedia, pada kolom API Key dan API Host.
5. Pastikan penyedianya aktif: tombol sakelarnya ada di pojok kanan atas halamannya. Di V2, penyedia baru ditambahkan dalam keadaan nonaktif, dan model dari penyedia yang nonaktif tidak muncul di daftar pilihan.

Bagaimana Cherry Studio merangkai alamat. Kolom API Host menerima alamat dasar, dan aplikasi menambahkan jalurnya sendiri lalu menampilkan hasilnya di baris Preview di bawah kolom. Aturannya sama di kedua versi:

Di instruksi lama masih ada satu aturan lagi: garis miring di akhir alamat konon menonaktifkan /v1. Aturan itu berlaku di versi-versi awal, hingga lini 1.6, dan sudah dihapus di 1.7: di build terkini, hanya # yang menonaktifkan penambahan otomatis.

Penyedia telah ditambahkan, tetapi belum terlihat di chat: hanya model yang Anda tambahkan secara eksplisit yang akan masuk ke daftar pilihan Cherry Studio. Ada dua cara.

Daftar dari server. Di halaman penyedia, klik Sync models (di V1 — Manage, lalu Fetch model list). Cherry Studio akan meminta GET /v1/models ke gateway dan akan menampilkan komposisi jaringan secara langsung; tambahkan model yang diperlukan dengan tombol +. Secara manual. Tombol Add Model membuka formulir di mana satu kolom wajib diisi — Model ID: pengidentifikasi harus dimasukkan karakter demi karakter.

Harga model jaringan sama, jadi tambahkan semuanya — Anda harus memilih di antara mereka berdasarkan perilaku, bukan berdasarkan anggaran:

Tipe model. Setiap model dalam daftar memiliki tombol pengaturan di mana kemampuannya ditandai: Vision, Reasoning, Tool, dan lainnya. Cherry Studio menandai beberapa opsi secara otomatis, tetapi untuk model gateway, sebaiknya diperiksa kembali. Vision harus dilepas: model jaringan adalah model teks. Tool diperlukan jika Anda menghubungkan alat MCP — panggilan alat asli didukung oleh semua model dari tabel. Reasoning sesuai untuk GLM-5.3 Flash — ini adalah model penalaran jaringan.

Model default. Di bagian pengaturan Default Model, model untuk peran utilitas ditentukan. Sebagai model asisten utama, atur DeepSeek V4 Flash. Untuk model cepat yang membuat judul dialog dan menyiapkan kueri pencarian, dokumentasi Cherry Studio menyarankan model yang ringan dan cepat, bukan model penalaran — dari model jaringan yang tersedia untuk peran ini, MiniMax M2.7 paling cocok, dan jangan gunakan GLM-5.3 Flash di sini karena penalaran wajibnya. Untuk terjemahan, salah satu dari dua yang pertama akan cocok.

Pada halaman penyedia di blok kunci terdapat tombol Model Check (di V1 — Check di sebelah kolom kunci). Pilih model — Cherry Studio akan mengirimkan permintaan uji singkat kepadanya dan menampilkan hasilnya beserta latensi respons. Jika pemeriksaan berhasil, masuk ke chat, pilih model gateway di pemilih model, dan ajukan pertanyaan apa pun.

Untuk memastikan permintaan benar-benar melalui gateway, buka dasbornya, bagian «Penggunaan»: di blok «Berdasarkan kunci», permintaan dan waktu akses terakhir akan muncul untuk kunci Cherry Studio; di blok «Berdasarkan model», model yang dipilih akan muncul. V2 juga memiliki statistik klien sendiri di bagian pengaturan Usage: token dan permintaan berdasarkan penyedia, model, dan kunci. Biaya di sana hanya sebagai referensi — Cherry Studio memperkirakannya berdasarkan harga publik model, bukan berdasarkan harga jaringan Gonka, jadi lihat jumlah pastinya di dasbor gateway.

Jika terjadi kesalahan, penyebabnya hampir selalu dapat dibaca dari respons:

Klien itu sendiri didistribusikan secara gratis, Anda hanya membayar untuk inferensi. Melalui JoinGonka Gateway, token berharga $0.0069 per juta di input dan $0.021 per juta di output — harga sama untuk semua model jaringan dan dimasukkan pada halaman ini dari sumber langsung. Chat menggunakan token jauh lebih hemat daripada alat agen, jadi urutan jumlah untuk harga pada September 2026 adalah sebagai berikut:

Catatan penting tentang dialog panjang: dengan setiap balasan, klien mengirimkan kembali seluruh riwayat ke model, sehingga balasan keseratus lebih mahal daripada yang pertama. Solusinya — dialog baru untuk tugas baru; di Cherry Studio, itu hanya satu tombol.

Perbandingan model dalam satu dialog. Cherry Studio dapat menanyakan satu pertanyaan ke beberapa model sekaligus: pilih model tersebut di pemilih model, dan masing-masing akan menjawab dengan permintaan terpisah. Dengan satu harga untuk semua model jaringan, ini adalah cara tercepat untuk memahami tugas Anda di mana MiniMax M2.7 sudah cukup, di mana jawaban panjang DeepSeek V4 Flash diperlukan, dan di mana penalaran GLM-5.3 Flash terbayarkan — pengaturannya telah dibahas dalam tinjauan model.

Protokol kedua dengan kunci yang sama. Gateway juga merespons dalam format Anthropic. Dalam dialog V2, terdapat baris Anthropic terpisah di blok Endpoint settings: masukkan https://gate.joingonka.ai di sana, dan di baris Request path seharusnya muncul jalur /v1/messages. Dalam V1, hasil yang sama didapatkan dengan penyedia terpisah dengan Provider Type Anthropic dan alamat yang sama. Di bawah tombol More options dalam V2, juga terdapat baris OpenAI Responses — gateway juga melayaninya, alamatnya sama dengan baris OpenAI utama.

Menjalankan agen terminal. Pada halaman Code CLI (dalam dokumentasi disebut Coding Companion), Cherry Studio menginstal dan menjalankan agen konsol, dengan menyertakan penyedia dan model dari pengaturannya; daftar penyedia di sana difilter berdasarkan protokol yang diperlukan oleh alat tertentu. Oleh karena itu, alamat Anthropic harus diisi terlebih dahulu jika Anda berniat menjalankan Claude Code dari sini. Cara mengonfigurasi agen yang sama tanpa perantara — lihat panduan Claude Code + Gonka.

Basis pengetahuan. Dalam V2, fitur ini berfungsi bahkan tanpa model embedding — menggunakan pencarian teks BM25, dan dengan model embedding, pencarian hibrida diaktifkan. Model jaringan Gonka bersifat generatif, jadi untuk mode hibrida gunakan model embedding dari penyedia lain, misalnya lokal melalui Ollama; namun, jawaban berdasarkan fragmen yang ditemukan akan diberikan oleh model gateway.

Butuh obrolan tim bersama di browser? Cherry Studio adalah klien desktop pribadi. Untuk antarmuka web bersama dengan akun, lihat Open WebUI: ia terhubung ke gateway dengan alamat dan kunci yang sama.