Cherry Studio'da kendi API'nizi ayarlamak için yol 設定 → 模型供應商 → 新增供應商'dır: API anahtarını girin, “端點設定” bölümündeki OpenAI ve Anthropic alanlarının her birine bir kök adres yazın, kaydettikten sonra “同步模型” düğmesine basarak modelleri alın ve “檢查” ile doğrulayın.Bu makale, 30 Eylül 2026'da yayımlanan v2.1.4 temel alınarak hazırlanmıştır; menü adları Cherry Studio'nun Geleneksel Çince arayüzündeki özgün hâlleriyle yazılmıştır. v2'de sağlayıcı ekleme ekranı büyük ölçüde değişti; v1 dönemindeki “類型選 OpenAI” anlatımı artık arayüzle uyuşmuyor.
Bu sayfa, CherryHQ/cherry-studio masaüstü sürümünü (AGPL-3.0; Windows, macOS ve Linux destekli) ele alır. 1 Ekim 2026'da yapılan kontrolde depo arşivlenmemişti ve son sürüm v2.1.4'tü. App Store'daki aynı adlı uygulama, başka bir geliştiriciye ait ilgisiz bir üründür. Ayrıca Cherry Studio'nun resmî belgeleri Basitleştirilmiş Çincedir; arayüz Geleneksel Çinceye geçirildiğinde “提供商／服務商” yerine “供應商” görünür. Belgelerle karşılaştırırken ad farklarının kafanızı karıştırmasına izin vermeyin.
Adım adım ayarlama
設定 → 模型供應商 → 新增供應商
（對話框標題：新增自訂供應商）
供應商名稱 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 留空
→ 儲存 → 在模型清單按「同步模型」→ 加入要用的模型 → 「檢查」- Ayarlar → Model sağlayıcıları'nı açın ve Sağlayıcı ekle'ye tıklayın. Açılan iletişim kutusunun başlığı “Özel sağlayıcı ekle”dir. Coding Plan türü hizmetler, birden fazla hesap veya proje bazlı kullanım için üstteki “Varsayılanla başla (isteğe bağlı)” seçeneğiyle mevcut bir varsayılandan oluşturabilirsiniz.
- Sağlayıcı adı ve API anahtarı alanlarını doldurun.
- Uç nokta ayarları bölümünde varsayılan olarak OpenAI Chat Completions ve Anthropic Messages alanları bulunur; en az bir metin uç noktası ayarlayın. İkisini de doldurursanız sohbet dışındaki Agent özellikleri ve Anthropic biçimini kullanan işlevler için de model seçebilirsiniz.
- Daha fazla seçenek'i genişletin. Burada OpenAI Responses, Google Gemini, görsel oluşturma temel URL'si ve görsel düzenleme temel URL'si bulunur. Kullanmayacaklarınızı boş bırakabilirsiniz.
- Kaydettikten sonra bu sağlayıcının etkin olduğundan emin olun. Resmî belgelere göre ayarlanmış ancak etkinleştirilmemiş sağlayıcının modelleri menüde görünmez — “anahtar çalışmıyor” sorununun en yaygın nedeni budur.
- Model listesinde Modelleri senkronize et'e tıklayın, kullanacağınız modelleri ekleyin ve birini test etmek için Kontrol et'e tıklayın.
Adres nasıl girilir: yalnızca kök adresi girin
v2.1.4 kaynak koduna göre her alan kök adresi kabul eder: sürüm bölümü yoksa /v1 otomatik eklenir (zaten varsa eklenmez), ardından ilgili alanın sabit yolu gelir. Her alanın altında “İstek yolu” gösterilir; gönderilecek son URL budur.
| Alan | Cherry Studio'nun bağlandığı yol | Kunavo |
|---|---|---|
| OpenAI Chat Completions | /chat/completions | Destekleniyor |
| Anthropic Messages | /messages | Destekleniyor |
| OpenAI Responses (Daha fazla seçenek) | /responses | Destekleniyor |
| Görsel oluşturma temel URL'si (Daha fazla seçenek) | /images/generations | Destekleniyor |
| Görsel düzenleme temel URL'si (Daha fazla seçenek) | /images/edits | Destekleniyor |
| Google Gemini (Daha fazla seçenek) | /models/{model}:generateContent | Desteklenmiyor, boş bırakın |
İki yaygın hata vardır: İlki, /chat/completions veya /messages içeren tam URL'yi yapıştırmak; yol tekrarlanır ve 404 döner. İkincisi, sona # eklemektir. Arayüz uyarısı açıkça şöyle der: “API sürümünün otomatik eklenmesini devre dışı bırakmak için sona # ekleyin.” Standart uç noktaya bunu eklerseniz /v1 kaybolur.
Ayarı doğru yapın, faturayı azaltın
Cherry Studio yalnızca sohbet için değil, arka planda da model çağırır. Hızlı model, arayüz açıklamasına göre “sohbet adlandırma, arama anahtar sözcüklerini çıkarma gibi basit görevler için kullanılan model”dir; ipucunda da “hafif bir model seçin ve akıl yürütme modeli kullanmaktan kaçının” yazar. Buraya ucuz bir model koyarsanız her sohbetin pahalı modeli bir tur çalıştırmasını önlersiniz. Çeviri modeli de ayrı yapılandırılır. Aynı anda birden fazla modele soru sorarsanız her modele ayrı istek gönderilir ve ayrı ücretlendirilir. Uygulamadaki kullanım istatistiklerinde gösterilen tutar, herkese açık fiyatlara göre hesaplanan tahmini değerdir; indirimli bir rota kullanıyorsanız yüksek görünebilir. Model ayarlarında birim fiyatı gerçek fiyatınıza değiştirirseniz doğru olur. Ayrıntılar için İngilizce Cherry Studio API maliyeti sayfasına bakın.
Kunavo kullanımı ve Tayvan ödemeleri hakkında notlar
- Doğrulama kapsamı:Yukarıdaki ayarlar Cherry Studio kaynak kodu ve resmî belgeleri okunarak derlenmiştir; Kunavo, Cherry Studio'yu kendi uç noktalarına gerçekten bağlayıp çalıştırmamıştır. Şu anda çalışan rotanızı koruyun ve bunu ayrıca deneyin.
- Yalnızca sohbet ve görseller:Kunavo'da embedding modeli yoktur. Bilgi tabanındaki vektör araması için başka bir sağlayıcı veya yerel embedding modeli kullanmanız gerekir; resmî belgelere göre embedding modeli yoksa bilgi tabanı BM25 anahtar sözcük aramasıyla çalışmaya devam eder.
- MCP araçları: Ayarlar → MCP sunucuları bölümünden eklenen araçların çalıştırılabilmesi için araç çağrısını destekleyen bir model gerekir; yukarıda eklenen Claude ve GPT modelleri bunu destekler.
- Ödeme: Ön ödemeli yükleme, token kullanımına göre ücretlendirme, aylık ücret yok. Minimum yükleme $10, ödeme Stripe üzerinden yapılır; Tayvan'da kredi kartları (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay ve Link kullanılabilir. JkoPay ve LINE Pay kullanılabilir yöntemler listesinde değildir. Faturalandırma açıklamasına bakın; hazır olduğunuzda hesap oluşturabilir ve anahtar üretebilirsiniz. İngilizce ayar sayfası Cherry Studio entegrasyon kılavuzudur.
Sık sorulan sorular
Cherry Studio'da kendi API'mi nasıl ayarlarım?
Ayarlar → Model sağlayıcıları → Sağlayıcı ekle'ye gidin, “Özel sağlayıcı ekle” iletişim kutusunu açın; sağlayıcı adını ve API anahtarını girin, uç nokta ayarlarındaki OpenAI Chat Completions ve Anthropic Messages alanlarına kök adresi yazıp kaydedin. Ardından model listesindeki “Modelleri senkronize et” düğmesiyle modelleri alın, kullanacağınız modelleri ekleyin ve birinin çalıştığını “Kontrol et” ile doğrulayın. Sağlayıcının etkin olması gerekir; aksi hâlde model menüde görünmez.
Cherry Studio API adresine /v1 eklemeli miyim?
İkisi de olur. v2.1.4 kaynak kodu, girdiğiniz kök adresin sonuna sürümü (/v1) otomatik ekler; zaten varsa tekrarlamaz. Ardından ilgili alanın kendi yolunu ekler (OpenAI için /chat/completions, Anthropic için /messages). Kaçınmanız gereken şey, /chat/completions içeren tam URL'yi yapıştırmaktır; yol tekrarlanır ve 404 döner. Sondaki #, “API sürümünün otomatik eklenmesini devre dışı bırakmak” içindir; standart uç noktalara eklemeyin. Her alanın altında “İstek yolu” gösterilir; kaydetmeden önce kontrol ederek son URL'yi görebilirsiniz.
“Modelleri senkronize et” hiçbir model getirmiyorsa 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 çoğunlukla Cherry Studio'da değil, adres veya anahtardadır. Tam URL yapıştırmadığınızı ve sonda # bulunmadığını doğrulayın; ardından aynı adres ve anahtarı curl ile test edin: JSON dönüyorsa sorun uygulamadadır, 401 dönüyorsa anahtar yanlıştır.
Cherry Studio Geleneksel Çinceye geçirilebilir mi?
Evet. Cherry Studio'nun arayüzünde Geleneksel Çince (zh-TW) dâhil 13 dil yerleşik olarak bulunur; ayarlardaki dil seçeneğinden değiştirebilirsiniz. Geleneksel Çince arayüzde hizmet sağlayıcı için “供應商” kullanılır; resmî belgelerde ve Basitleştirilmiş Çince arayüzde “提供商” veya “服務商” yazabilir. Adlar farklı olsa da aynı şeyi ifade eder.
Cherry Studio ücretli mi?
Masaüstü sürümü (topluluk sürümü) AGPL-3.0 lisanslı, açık kaynaklı ve ücretsizdir. Ödeme yapacağınız şey, yapılandırdığınız sağlayıcının model kullanım ücretleridir. Cherry Studio Enterprise ayrıca fiyatlandırılan ticari bir üründür; yerleşik CherryAI ücretsizdir, ancak model kataloğu ve kotaları herkese açık değildir.
1 Ekim 2026 doğrulaması: GitHub API'si (CherryHQ/cherry-studio, v2.1.4), v2.1.4 Geleneksel Çince arayüz dizeleri (zh-tw.json), sağlayıcı ekleme ekranının kaynak kodu ve Cherry Studio resmî belgeleri. Kunavo, kendi uç noktalarını Cherry Studio ile fiilen çalıştırmamıştır.