Dokumentasi

Cherry Studio

Penyedia kustom Cherry Studio menggunakan alamat root terpisah untuk setiap protokol — OpenAI, Anthropic, Gemini. Tempelkan kunci dan alamat root, tekan Sinkronkan Model, lalu katalog akan mengisi pemilih secara otomatis.

Settings → Model Services → provider khusus: tempel key dan alamat API, klik Get Model List, lalu seluruh katalog mengisi pemilih.

Cherry Studio

设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)

  提供商名称 / Provider name    Kunavo
  API 密钥 / API Key            sk-kn-...
  端点设置 / Endpoint settings
    OpenAI                     https://api.kunavo.com/v1
    Anthropic                  https://api.kunavo.com
  → 同步模型 (Sync Models), then add the models you want
  → 检测 (Test) to confirm

Sinkronkan Model / Sync Models memanggil GET /v1/models menggunakan root dari kolom yang Anda isi, beserta kunci yang dimasukkan. Karena itu, ini juga cara tercepat untuk menguji apakah pasangan tersebut benar — daftar kosong hampir selalu berarti masalah pada kunci atau alamat, bukan penyedia.

Setiap kolom endpoint menerima alamat root, bukan URL endpoint lengkap. Cherry Studio menambahkan segmen versinya sendiri (dilewati jika root Anda sudah diakhiri segmen versi, sehingga https://api.kunavo.com dan https://api.kunavo.com/v1 sama-sama berfungsi untuk kolom OpenAI), lalu selalu menambahkan rutenya sendiri untuk kolom tersebut. Tempelkan URL endpoint lengkap — yang sudah diakhiri /chat/completions atau /messages — maka rute itu akan ditambahkan sekali lagi dan permintaan akan menghasilkan 404.

Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Cherry Studio.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Buka 设置 → 模型服务 (Pengaturan → Layanan Model), lalu 添加自定义提供商 (Tambah Penyedia Kustom).
Isi API 密钥 (kuncinya) dan kolom endpoint OpenAI (https://api.kunavo.com/v1).
Isi juga kolom Anthropic (https://api.kunavo.com) — kolom ini berada di bawah OpenAI pada 端点设置 (Pengaturan Endpoint). Cherry Agent dan model apa pun yang dirutekan melalui protokol Anthropic Messages membaca dari kolom ini secara khusus, bukan kolom OpenAI. Jenis endpoint lainnya berada di 更多设置 (Pengaturan Lainnya).
Simpan, lalu tekan 同步模型 di daftar model penyedia dan tambahkan model chat yang Anda inginkan; tekan 检测 untuk memverifikasi salah satunya dari awal hingga akhir.
Tetapkan model per asisten, bukan secara global — Cherry Studio menyimpan model untuk setiap asisten, sehingga pilihan bawaan yang murah dan spesialis yang mahal dapat digunakan bersamaan.

Diperiksa terhadap Dokumentasi penyedia Cherry Studio pada 1 Oktober 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Cherry Studio.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

ID model	Kunavo masuk / keluar	Kegunaannya di Cherry Studio
`claude-sonnet-5`	$1.40 / $7.00	asisten sehari-hari
`claude-opus-5`	$3.50 / $17.50	asisten khusus untuk masalah sulit
`claude-haiku-4-5`	$0.70 / $3.50	penerjemahan, peringkasan, dan tugas apa pun dengan volume tinggi
`gpt-5-6-terra`	$0.70 / $4.20	dokumen panjang dan konteks besar yang ditempel

Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Pertanyaan umum

Bagaimana cara menambahkan penyedia API kustom ke Cherry Studio?

Buka Pengaturan → Layanan Model (设置 → 模型服务), lalu pilih Tambah Penyedia Kustom (添加自定义提供商). Setiap jenis endpoint memiliki alamat root tersendiri — OpenAI dan Anthropic ditampilkan secara bawaan, sedangkan OpenAI Responses, Gemini, dan endpoint gambar berada di Pengaturan Lainnya (更多设置) — serta menggunakan satu kunci API. Masukkan kunci dan root endpoint yang diperlukan, tekan Sinkronkan Model (同步模型) untuk mengambil katalog, tambahkan model yang diinginkan, lalu gunakan Uji (检测) untuk memastikan salah satunya berfungsi.

Mengapa Sinkronkan Model di Cherry Studio tidak menampilkan apa pun?

Tombol itu memanggil rute /v1/models dari kolom OpenAI dengan kunci yang Anda masukkan, jadi hasil kosong menunjukkan masalah pada alamat kolom tersebut atau kunci, bukan pada Cherry Studio. Setiap kolom menerima alamat root — Cherry Studio menambahkan versi dan rute sendiri — jadi periksa apakah Anda menempelkan URL endpoint lengkap (yang sudah diakhiri /chat/completions), lalu coba pasangan yang sama dengan curl: jika JSON diterima, masalahnya ada di aplikasi; 401 berarti kuncinya salah.

Apa fungsi tanda # di akhir kolom endpoint Cherry Studio?

Dokumentasi Cherry Studio sendiri menjelaskan bahwa tanda itu mengunci kolom ke path tetap, untuk endpoint yang rutenya tidak mengikuti format standar. Endpoint OpenAI dan Anthropic Kunavo mengikuti format standar, jadi Anda tidak memerlukannya — masukkan alamat root, dengan atau tanpa /v1, lalu biarkan Cherry Studio menambahkan sisanya.

Bisakah Cherry Studio menggunakan model Claude tanpa akun Anthropic?

Ya, jika gateway menyediakannya — masukkan alamat Kunavo secara khusus di kolom Anthropic, bukan kolom OpenAI, karena Cherry Agent dan model apa pun yang dirutekan melalui protokol Anthropic Messages membaca dari kolom tersebut. Cherry Studio mengirimkan ID model ke endpoint yang tercantum dalam entri penyedia, sehingga ID Claude diidentifikasi di sana dan satu-satunya kredensial yang dipegang Cherry Studio adalah kunci endpoint tersebut.