Pengaturan API Cherry Studio: penyedia kustom, alamat, dan model

Jalur untuk mengatur API di Cherry Studio adalah Settings → Model Provider → Add Provider. Masukkan API Key, masukkan alamat root pada kolom OpenAI dan Anthropic di Endpoint settings, lalu simpan, gunakan ‘Sync models’ untuk mengambil model, dan periksa dengan ‘Check’. Hal yang perlu diketahui terlebih dahulu: Cherry Studio tidak memiliki UI bahasa Korea, jadi menu ditulis persis dalam bahasa Inggris. Halaman ini berdasarkan v2.1.4 yang dirilis pada 30 September 2026. Karena layar penambahan penyedia berubah besar pada v2, penjelasan cara v1 dengan ‘Type: OpenAI’ tidak lagi sesuai dengan tampilan saat ini.

Sasarannya adalah versi desktop CherryHQ/cherry-studio (AGPL-3.0, Windows·macOS·Linux). Per 1 Oktober 2026, repositori belum diarsipkan dan versi terbaru adalah v2.1.4. Aplikasi dengan nama yang sama di App Store adalah aplikasi yang tidak terkait dari developer lain. UI bawaan memiliki 13 bahasa dan tidak mencakup bahasa Korea (berdasarkan berkas terjemahan UI v2.1.4), jadi panduan ini mengasumsikan penggunaan UI bahasa Inggris.

Pengaturan langkah demi langkah

Settings → Model Provider → Add Provider
  (대화상자 제목: Add Custom Provider)

  Provider Name       Kunavo
  API Key             sk-kn-...
  Endpoint settings
    OpenAI            https://api.kunavo.com/v1
    Anthropic         https://api.kunavo.com
  More options
    OpenAI Responses            https://api.kunavo.com/v1   (선택)
    Image Generation Base URL   https://api.kunavo.com/v1   (선택)
    Gemini                      비워 둠

→ Save → 모델 목록에서 "Sync models" → 쓸 모델 추가 → "Check"

1. Di Settings → Model Provider, klik Add Provider. Judul dialog yang terbuka adalah ‘Add Custom Provider’. Jika memerlukan layanan kategori Coding Plan, beberapa akun, atau pemisahan proyek, Anda juga dapat memulai dari preset yang ada melalui ‘Start from a preset (optional)’ di bagian atas.
2. Masukkan Provider Name dan API Key.
3. Endpoint settings sejak awal memiliki dua kolom: OpenAI dan Anthropic. Setidaknya satu endpoint teks diperlukan (jika dikosongkan, muncul kesalahan ‘Configure at least one text endpoint’). Jika kedua kolom diisi, model dapat dipilih tidak hanya untuk chat, tetapi juga untuk Agent atau fitur yang menggunakan format Anthropic.
4. Buka More options untuk melihat kolom OpenAI Responses, Gemini, Image Generation Base URL, dan Image Edit Base URL. Biarkan kolom yang tidak digunakan tetap kosong.
5. Setelah menyimpan, pastikan penyedia tersebut diaktifkan (Enable). Menurut dokumentasi resmi, penyedia yang hanya dikonfigurasi tetapi tidak diaktifkan tidak akan muncul dalam daftar pilihan model. Ini adalah penyebab paling umum “kunci tidak berfungsi”.
6. Gunakan Sync models dalam daftar model untuk mengambil model, tambahkan model yang ingin digunakan, lalu periksa salah satunya dengan Check.

Cara menulis alamat: hanya alamat root

Berdasarkan sumber v2.1.4, masukkan alamat root pada setiap kolom. Jika bagian versi tidak ada, /v1 akan ditambahkan otomatis (jika sudah ada, tidak ditambahkan), lalu jalur tetap per kolom akan ditambahkan. URL final ditampilkan sebagai ‘Request path’ di bawah setiap kolom, jadi periksa sebelum menyimpan.

Ada dua kesalahan umum. Jika menempelkan URL lengkap yang sudah mencakup /chat/completions atau /messages, jalurnya akan ditambahkan dua kali dan menghasilkan 404. Selain itu, # di akhir adalah simbol yang, sesuai petunjuk layar, berarti ‘Add # at the end to disable the automatically appended API version’; jika ditempelkan pada endpoint standar, /v1 akan hilang. Untuk memeriksa alamat dan kunci itu sendiri, perintah berikut adalah cara tercepat.

curl https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer $KUNAVO_API_KEY"

Pengaturan model dasar untuk menghemat biaya

Cherry Studio memanggil model di latar belakang selain untuk chat. Quick Model digunakan, sesuai penjelasan layar, untuk ‘tugas sederhana seperti memberi nama percakapan dan mengekstrak kata kunci pencarian’, dan petunjuknya juga menyarankan ‘memilih model ringan dan menghindari model reasoning’. Dengan memasukkan model murah di sini, model mahal tidak dijalankan setiap kali Anda bercakap-cakap. Atur juga Translate Model secara terpisah. Jika memilih beberapa model dan mengajukan satu pertanyaan sekaligus, permintaan dikirim dan ditagihkan secara terpisah sebanyak jumlah model. Jumlah dalam statistik penggunaan aplikasi adalah perkiraan yang dikonversi berdasarkan harga publik, sehingga pada jalur yang mendapat diskon hasilnya lebih tinggi daripada biaya sebenarnya. Ubah harga satuan dalam pengaturan model ke tarif aktual agar sesuai. Untuk detail, lihat halaman berbahasa Inggris Cherry Studio API cost.

Hal yang perlu diperhatikan dan pembayaran saat menggunakan Kunavo

• Cakupan verifikasi: Pengaturan ini ditulis berdasarkan sumber dan dokumentasi resmi Cherry Studio; Kunavo belum memverifikasi dengan benar-benar menghubungkan dan menjalankan Cherry Studio ke endpoint miliknya. Pertahankan jalur yang sedang digunakan dan uji dengan hati-hati.
• Hanya chat dan gambar: Kunavo tidak memiliki model embedding, sehingga pencarian vektor dalam basis pengetahuan memerlukan penyedia lain atau model embedding lokal. Dokumentasi resmi menjelaskan bahwa basis pengetahuan tetap dapat bekerja dengan pencarian kata kunci BM25 meskipun tidak ada model embedding.
• Alat MCP: Alat yang ditambahkan dari Settings → MCP Servers harus digunakan dengan model yang mendukung pemanggilan alat. Model Claude·GPT yang ditambahkan di atas mendukungnya.
• Pembayaran: Pengisian saldo prabayar tanpa biaya bulanan; saldo dipotong berdasarkan token. Pengisian minimum adalah $10, dan checkout Stripe menerima kartu (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay, serta Link. Jika checkout ditampilkan dalam won Korea, KakaoPay, Naver Pay, PAYCO, Samsung Pay, dan kartu domestik yang memblokir pembayaran luar negeri juga tersedia (ditambahkan pada 3 Oktober 2026; belum ada pembayaran menggunakan metode ini). Jumlah ditetapkan dalam dolar dan tampilan dalam won dikonversi oleh Stripe; kurs tersebut mencakup biaya konversi 2–4% yang dibayar oleh pembayar. Toss Pay tidak tersedia. Baca panduan pembayaran, lalu buat akun untuk menerbitkan kunci. Halaman pengaturan berbahasa Inggris adalah Cherry Studio integration guide.

Pertanyaan umum

Diverifikasi pada 1 Oktober 2026: GitHub API (CherryHQ/cherry-studio, v2.1.4), daftar berkas terjemahan UI v2.1.4 dan string UI bahasa Inggris (en-us.json), sumber layar penambahan penyedia, serta dokumentasi resmi Cherry Studio. Kunavo belum menjalankan Cherry Studio pada endpoint miliknya.