Pengaturan API Cherry Studio: menambahkan penyedia khusus, alamat, dan model

Untuk mengatur API sendiri di Cherry Studio, buka 設定 → 模型供應商 → 新增供應商: masukkan kunci API, isi satu alamat dasar pada masing-masing kolom OpenAI dan Anthropic di “端點設定”, simpan, lalu klik “同步模型” untuk mengambil model dan gunakan “檢查” untuk melakukan konfirmasi.Artikel ini mengacu pada v2.1.4 yang dirilis pada 30 September 2026; semua nama menu ditulis persis seperti teks asli antarmuka Tionghoa Tradisional Cherry Studio. v2 mengubah besar-besaran layar penambahan penyedia, sehingga tutorial era v1 yang menyebut “類型選 OpenAI” tidak lagi sesuai dengan antarmuka.

Halaman ini merujuk pada versi desktop CherryHQ/cherry-studio (AGPL-3.0, mendukung Windows, macOS, Linux). Saat diverifikasi pada 1 Oktober 2026, repositorinya tidak diarsipkan dan versi terbaru adalah v2.1.4. Aplikasi bernama sama di App Store adalah produk tidak terkait dari pengembang lain. Selain itu, dokumentasi resmi Cherry Studio menggunakan bahasa Tionghoa Sederhana; setelah antarmuka diubah ke Tionghoa Tradisional, “提供商／服務商” ditampilkan sebagai “供應商”, jadi jangan terkecoh oleh perbedaan nama saat mencocokkan antarmuka dengan dokumentasi.

Penyiapan langkah demi langkah

設定 → 模型供應商 → 新增供應商
  （對話框標題：新增自訂供應商）

  供應商名稱                 Kunavo
  API 金鑰                   sk-kn-...
  端點設定
    OpenAI Chat Completions  https://api.kunavo.com/v1
    Anthropic Messages       https://api.kunavo.com
  更多選項
    OpenAI Responses         https://api.kunavo.com/v1   （選填）
    影像產生基礎 URL           https://api.kunavo.com/v1   （選填）
    Google Gemini            留空

→ 儲存 → 在模型清單按「同步模型」→ 加入要用的模型 → 「檢查」

1. Buka Pengaturan → Penyedia Model, lalu klik Tambahkan Penyedia. Dialog yang muncul berjudul “Tambahkan Penyedia Kustom”. Untuk layanan seperti Coding Plan, banyak akun, atau pemisahan proyek, Anda dapat menggunakan “Mulai dari default (opsional)” di bagian atas untuk membuatnya dari default yang sudah ada.
2. Isi Nama penyedia dan Kunci API.
3. Pengaturan Endpoint secara default memiliki dua kolom: OpenAI Chat Completions dan Anthropic Messages. Setidaknya satu endpoint teks harus diatur. Jika keduanya diisi, model juga dapat dipilih untuk Agent di luar chat dan fitur yang menggunakan format Anthropic.
4. Buka Opsi lainnya; tersedia OpenAI Responses, Google Gemini, URL dasar pembuatan gambar, dan URL dasar pengeditan gambar. Biarkan kosong jika tidak diperlukan.
5. Setelah menyimpan, pastikan penyedia ini berstatus Aktif. Dokumentasi resmi menyatakan bahwa penyedia yang sudah diatur tetapi belum diaktifkan tidak akan menampilkan model di menu—ini adalah penyebab paling umum “kunci tidak bereaksi”.
6. Pada daftar model, klik Sinkronkan Model, tambahkan model yang ingin digunakan, lalu klik Periksa untuk menguji salah satunya.

Cara mengisi alamat: hanya isi alamat dasar

Menurut kode sumber v2.1.4, setiap kolom diisi dengan alamat dasar: jika tidak ada segmen versi, /v1 akan ditambahkan otomatis (jika sudah ada, tidak ditambahkan), lalu jalur tetap kolom tersebut ditambahkan. Di bawah setiap kolom ditampilkan “Jalur permintaan”, yaitu URL final yang dikirim.

Dua kesalahan umum: pertama, menempelkan URL lengkap yang mengandung /chat/completions atau /messages, sehingga jalur berulang dan menghasilkan 404; kedua, menambahkan # di akhir. Petunjuk antarmuka sangat jelas: “Tambahkan # di akhir untuk menonaktifkan penambahan otomatis versi API.” Jika ditambahkan pada endpoint standar, /v1 akan hilang.

Atur sekalian, kurangi tagihan

Selain chat, Cherry Studio juga memanggil model di latar belakang. Menurut penjelasan antarmuka, Model cepat digunakan “untuk tugas sederhana seperti memberi nama percakapan dan mengekstrak kata kunci pencarian”, dengan petunjuk “pilih model ringan dan hindari model penalaran”. Tempatkan model murah di sini agar model mahal tidak berjalan setiap kali percakapan. Model terjemahan juga diatur terpisah. Jika memilih beberapa model untuk ditanya secara bersamaan, setiap model mengirim satu permintaan dan dikenai biaya satu kali. Statistik penggunaan dalam aplikasi menampilkan nilai perkiraan yang dihitung berdasarkan harga publik; jika menggunakan rute berdiskon, nilainya akan terlalu tinggi. Ubah harga satuan dalam pengaturan model ke harga aktual Anda agar akurat. Lihat Cherry Studio API cost versi bahasa Inggris untuk detail selengkapnya.

Catatan penggunaan Kunavo dan pembayaran di Taiwan

• Cakupan verifikasi: Pengaturan di atas dirangkum dari kode sumber dan dokumentasi resmi Cherry Studio; Kunavo belum benar-benar menghubungkan Cherry Studio ke endpoint miliknya. Pertahankan rute yang saat ini berfungsi, lalu uji rute ini.
• Hanya chat dan gambar: Kunavo tidak memiliki model embedding; pencarian vektor basis pengetahuan harus menggunakan penyedia lain atau model embedding lokal. Dokumentasi resmi menyatakan bahwa tanpa model embedding, basis pengetahuan tetap beroperasi menggunakan pencarian kata kunci BM25.
• Alat MCP: Alat yang ditambahkan di Pengaturan → Server MCP hanya dapat dipanggil oleh model yang mendukung pemanggilan alat; model Claude dan GPT yang ditambahkan di atas semuanya mendukungnya.
• Pembayaran: saldo prabayar, ditagih berdasarkan token, tanpa biaya bulanan. Pengisian minimum $10, checkout melalui Stripe, dan di Taiwan tersedia kartu kredit (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay, serta Link; JkoPay dan LINE Pay tidak ada dalam daftar yang tersedia. Lihat penjelasan penagihan; setelah siap, Anda dapat membuat akun dan menghasilkan kunci. Halaman pengaturan bahasa Inggris adalah panduan integrasi Cherry Studio.

Pertanyaan umum

Diverifikasi pada 1 Oktober 2026: GitHub API (CherryHQ/cherry-studio, v2.1.4), string antarmuka Tionghoa Tradisional v2.1.4 (zh-tw.json), kode sumber layar penambahan penyedia, dan dokumentasi resmi Cherry Studio. Kunavo belum menjalankan endpoint miliknya secara langsung melalui Cherry Studio.