Cherry Studio'da API yapılandırma yolu Settings → Model Provider → Add Provider'dır. API Key'i girin, Endpoint settings bölümündeki OpenAI ve Anthropic alanlarına kök adresleri tek tek yazın, ardından kaydedip ‘Sync models’ ile modelleri alın ve ‘Check’ ile doğrulayın. Önceden bilinmesi gereken nokta: Cherry Studio'da Korece arayüz yoktur; bu nedenle menüleri İngilizce asıllarıyla yazdık. Bu sayfa 30 Eylül 2026'da yayımlanan v2.1.4 temel alınarak hazırlanmıştır. v2'de sağlayıcı ekleme ekranı büyük ölçüde değiştiği için v1 dönemindeki ‘Type: OpenAI’ açıklaması artık ekranla uyuşmuyor.
Hedef, CherryHQ/cherry-studio masaüstü sürümüdür (AGPL-3.0, Windows·macOS·Linux). 1 Ekim 2026 itibarıyla depo arşivlenmemiştir ve en yeni sürüm v2.1.4'tür. App Store'daki aynı adlı uygulama başka bir geliştiriciye ait, ilgisiz bir uygulamadır. Yerleşik arayüz dili sayısı 13'tür ve Korece yoktur (v2.1.4 arayüz çeviri dosyalarına göre); bu nedenle talimatları İngilizce arayüz üzerinden izlemeniz varsayılır.
Adım adım yapılandırma
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"- Settings → Model Provider bölümünde Add Provider'a tıklayın. Açılan iletişim kutusunun başlığı ‘Add Custom Provider’dır. Coding Plan türü hizmetler, birden çok hesap veya proje ayrımı gerekiyorsa üstteki ‘Start from a preset (optional)’ seçeneğiyle mevcut bir ön ayardan da başlayabilirsiniz.
- Provider Name ve API Key alanlarını doldurun.
- Endpoint settings bölümünde başlangıçta OpenAI ve Anthropic olmak üzere iki alan bulunur. En az bir metin uç noktası gereklidir (boş bırakılırsa ‘Configure at least one text endpoint’ hatası alınır). İki alanı da doldurursanız yalnızca sohbet için değil, Agent veya Anthropic biçimini kullanan özelliklerde de model seçebilirsiniz.
- More options bölümünü açtığınızda OpenAI Responses, Gemini, Image Generation Base URL ve Image Edit Base URL alanları görünür. Kullanmadığınız alanları boş bırakın.
- Kaydettikten sonra sağlayıcının etkin (Enable) olduğundan emin olun. Resmî belgelere göre yalnızca yapılandırılıp etkinleştirilmeyen sağlayıcılar model seçim listesinde görünmez. ‘Anahtar çalışmıyor’ sorununun en yaygın nedeni budur.
- Model listesinden Sync models ile modelleri alın, kullanacağınız modeli ekleyin ve Check ile bir modeli doğrulayın.
Adres yazma kuralı: yalnızca kök adres
v2.1.4 kaynak koduna göre her alana kök adresi girin. Sürüm bölümü yoksa /v1 otomatik eklenir (zaten varsa eklenmez), ardından alana özgü sabit yol eklenir. Her alanın altında nihai URL ‘Request path’ olarak gösterilir; kaydetmeden önce kontrol edin.
| Alan | Cherry Studio'nun eklediği yol | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | Destekleniyor |
| Anthropic | /messages | Destekleniyor |
| OpenAI Responses (More options) | /responses | Destekleniyor |
| Image Generation Base URL (More options) | /images/generations | Destekleniyor |
| Image Edit Base URL (More options) | /images/edits | Destekleniyor |
| Gemini (More options) | /models/{model}:generateContent | Desteklenmiyor, boş bırakın |
Yaygın iki hata vardır. /chat/completions veya /messages dahil tam URL'yi yapıştırırsanız yol iki kez eklenir ve 404 oluşur. Ayrıca sondaki #, ekrandaki açıklamaya göre ‘Add # at the end to disable the automatically appended API version’, yani sürümün otomatik eklenmesini kapatan simgedir; standart uç noktaya eklerseniz /v1 eksik kalır. Adresin ve anahtarın kendisini kontrol etmek için aşağıdaki komut en hızlı yoldur.
curl https://api.kunavo.com/v1/models \
-H "Authorization: Bearer $KUNAVO_API_KEY"Ücreti azaltmak için temel model ayarları
Cherry Studio, sohbetin yanı sıra arka planda da model çağırır. Quick Model, ekrandaki açıklamaya göre ‘sohbet adlandırma ve arama anahtar kelimelerini çıkarma gibi basit işler’ için kullanılır; açıklama ayrıca ‘hafif bir model seçin ve reasoning modelinden kaçının’ der. Buraya ucuz bir model koyarsanız her sohbette pahalı model çalışmaz. Translate Model de ayrıca ayarlanır. Birden fazla model seçerek tek seferde soru sorarsanız, model sayısı kadar ayrı istek gönderilir ve ayrı ücretlendirilir. Uygulamanın kullanım istatistiklerindeki tutar, genel fiyatlara dönüştürülmüş tahmindir; indirimli yollarda gerçek tutardan yüksek görünür. Model ayarlarında birim fiyatı gerçek ücrete çevirirseniz düzelir. Ayrıntılar için İngilizce Cherry Studio API cost sayfasına bakın.
Kunavo kullanırken dikkat edilmesi gerekenler ve ödeme
- Doğrulama kapsamı: Bu ayar Cherry Studio kaynak kodu ve resmî belgeler incelenerek hazırlanmıştır; Kunavo'nun Cherry Studio'yu kendi uç noktalarına gerçekten bağlayarak çalıştırdığı bir doğrulama değildir. Mevcut yolu değiştirmeden test edin.
- Sadece sohbet ve görseller: Kunavo'da embedding modeli yoktur; bu nedenle bilgi tabanında vektör araması için başka bir sağlayıcı veya yerel embedding modeli gerekir. Resmî belgeler, embedding modeli olmasa da bilgi tabanının BM25 anahtar kelime aramasıyla çalıştığını açıklar.
- MCP araçları: Settings → MCP Servers bölümünden eklenen araçları kullanmak için araç çağrısını destekleyen bir model gerekir. Yukarıda eklenen Claude ve GPT modelleri bunu destekler.
- Ödeme: Aylık ücret olmadan önceden bakiye yüklenir ve kullanım token bazında bakiyeden düşülür. Minimum yükleme tutarı $10’dir. Stripe ödeme sayfasında kart (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay ve Link kullanılabilir. Ödeme sayfası won cinsinden görüntülenirse KakaoPay, Naver Pay, PAYCO, Samsung Pay ve yurt dışı ödemeleri engellenmiş yerel kartlar da seçenek olarak sunulur (2026-10-03 tarihinde eklendi; henüz bu yöntemlerle ödeme yapılmadı). Tutarlar dolar cinsinden belirlenir; won gösterimi Stripe tarafından çevrilir ve kullanılan kur, ödemeyi yapan kişinin ödediği %2–4 döviz dönüşüm ücretini içerir. Toss Pay kullanılamaz. Ödeme bilgilerini inceleyin ve anahtarınızı almak için bir hesap oluşturun. İngilizce ayar sayfası Cherry Studio integration guide’dır.
Sık sorulan sorular
Cherry Studio'da API nasıl yapılandırılır?
Settings → Model Provider → Add Provider'a tıklayın; 'Add Custom Provider' iletişim kutusu açılır. Provider Name ve API Key alanlarını doldurun, Endpoint settings bölümündeki OpenAI ve Anthropic alanlarına kök adresi girip kaydedin. Ardından model listesinden 'Sync models' ile modelleri alın, kullanacağınız modeli ekleyin ve 'Check' ile bir modeli doğrulayın. Sağlayıcı etkinleştirilmiş (Enable) olmalıdır; aksi halde model seçim listesinde görünmez.
Cherry Studio Korece kullanılabilir mi?
Arayüz Koreceyi desteklemiyor. v2.1.4'teki arayüz dilleri İngilizce, Çince (basitleştirilmiş ve geleneksel), Japonca, Almanca, Fransızca, İspanyolca, Portekizce, Rusça, Yunanca, Romence, Türkçe ve Vietnamca olmak üzere 13 tanedir. Menüler çoğunlukla İngilizce kullanıldığından bu sayfada İngilizce menü adlarını aynen yazdık. Model ile yapılan konuşma ise Korece olabilir.
API adresine /v1 eklemeli miyim?
Ekleyebilir veya eklemeyebilirsiniz. v2.1.4 kaynak kodu, girilen kök adreste sürüm (/v1) yoksa otomatik olarak ekler; varsa olduğu gibi bırakır ve ardından alana özgü yolu (OpenAI için /chat/completions, Anthropic için /messages) ekler. Kaçınılması gereken şey, /chat/completions içeren tam URL'yi yapıştırmaktır; yol iki kez eklenir ve 404 oluşur. Sondaki #, sürümün otomatik eklenmesini kapatan bir simgedir; standart uç noktalarda kullanmayın. Nihai URL'yi alanın altındaki 'Request path' bölümünde görebilirsiniz.
Sync models'e bassam da modeller görünmüyorsa ne yapmalıyım?
Bu düğme, girdiğiniz adres ve anahtarla sağlayıcının model listesini (/v1/models) ister; liste boşsa sorun genellikle adres veya anahtardadır. Tam URL'yi yapıştırmadığınızı ve sonda # bulunmadığını kontrol ettikten sonra aynı adres ve anahtarla curl çalıştırmayı deneyin. JSON gelirse sorun uygulamadadır; 401 gelirse sorun anahtardadır.
Cherry Studio ücretsiz mi?
Masaüstü topluluk sürümü AGPL-3.0 açık kaynaklı olduğu için ücretsizdir. Ücretli olan, yapılandırdığınız sağlayıcının model kullanım ücretidir. Cherry Studio Enterprise teklif usulü ayrı bir üründür; yerleşik CherryAI ücretsizdir ancak model yapılandırması ve limitleri açıklanmamıştır.
1 Ekim 2026'da doğrulandı: GitHub API (CherryHQ/cherry-studio, v2.1.4), v2.1.4 arayüz çeviri dosyası listesi ve İngilizce arayüz dizeleri (en-us.json), sağlayıcı ekleme ekranı kaynak kodu ve Cherry Studio resmî belgeleri. Kunavo, Cherry Studio'yu kendi uç noktalarında çalıştırarak test etmemiştir.