Dokümantasyon
Cherry Studio
Cherry Studio'nun özel sağlayıcı yapılandırmasında her protokol (OpenAI, Anthropic, Gemini) için ayrı bir kök adres bulunur. Anahtarı ve kök adresleri yapıştırın, Sync Models'e basın; katalog model seçicisini kendiliğinden doldurur.
Settings → Model Services → özel sağlayıcı: anahtarı ve API adresini yapıştırın, Get Model List'e tıklayın ve tüm katalog seçicide doldurulsun.
设置 → 模型服务 → 添加 → 添加自定义提供商 (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 confirmGET /v1/models çağrısını yapar. Bu, aynı zamanda bu ikilinin doğru olup olmadığını sınamanın en hızlı yoludur: boş liste neredeyse her zaman sağlayıcıdan değil, anahtardan veya adresten kaynaklanır.https://api.kunavo.com ve https://api.kunavo.com/v1 ikisi de doğru şekilde çözümlenir) ve ardından o alanın kendi yolunu her zaman ekler. Tam uç nokta URL'sini yapıştırırsanız — zaten /chat/completions veya /messages ile biten bir URL — yol ikinci kez eklenir ve istek 404 verir.sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Cherry Studio kurulumunda açılır.Adım adım
/app/keysadresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.- 设置 → 模型服务 (Ayarlar → Model Hizmetleri) bölümünü açın ve 添加自定义提供商 (Özel Sağlayıcı Ekle) seçeneğini belirleyin.
- API 密钥 alanını (anahtar) ve OpenAI uç nokta alanını (
https://api.kunavo.com/v1) doldurun. - Anthropic alanını da doldurun (
https://api.kunavo.com). Bu alan, 端点设置 (Uç Nokta Ayarları) bölümünde OpenAI'nin altındadır. Cherry Agent ve Anthropic Messages protokolü üzerinden yönlendirilen tüm modeller özellikle bu alandaki bilgileri kullanır; OpenAI alanındakileri değil. Diğer uç nokta türleri 更多设置 (Diğer Seçenekler) bölümündedir. - Kaydedin, ardından sağlayıcının model listesinde 同步模型'e basıp istediğiniz sohbet modellerini ekleyin; uçtan uca doğrulamak için modellerden birinde 检测'e tıklayın.
- Modelleri genel olarak değil, her asistana ayrı ayrı atayın. Cherry Studio her asistan için bir model tuttuğundan, uygun maliyetli bir varsayılanla pahalı bir uzman modelin bir arada bulunmasını sağlar.
Cherry Studio'nun sağlayıcı belgeleri ile 1 Ekim 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.
İstemcide hata ayıklamadan önce doğrulayın
Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Cherry Studio içinde çalışır.
# 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-..."Alana hangi model kimliği yazılmalı
Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.
| Model kimliği | Kunavo giriş / çıkış | Cherry Studio içinde kullanım alanı |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | günlük kullanılan asistan |
claude-opus-5 | $3.50 / $17.50 | zor problemler için ayrılmış bir asistan |
claude-haiku-4-5 | $0.70 / $3.50 | çeviri, özetleme ve yüksek hacimli her türlü iş |
gpt-5-6-terra | $0.70 / $4.20 | uzun belgeler ve büyük yapıştırılmış bağlamlar |
Sık sorulan sorular
Cherry Studio'ya özel bir API sağlayıcısını nasıl eklerim?
Ayarlar → Model Hizmetleri (设置 → 模型服务) bölümünü açın ve Özel Sağlayıcı Ekle'yi (添加自定义提供商) seçin. Varsayılan olarak gösterilen OpenAI ve Anthropic uç noktalarının yanı sıra Diğer Seçenekler (更多设置) altında OpenAI Responses, Gemini ve görüntü uç noktaları bulunur; her uç nokta türü için ayrı bir kök adres ve bir API anahtarı girilir. Anahtarı ve gereken uç nokta köklerini girin, kataloğu getirmek için Sync Models (同步模型) düğmesine basın, istediğiniz modelleri ekleyin ve birinin çalıştığını doğrulamak için Test (检测) seçeneğini kullanın.
Cherry Studio'nun Sync Models seçeneği neden sonuç döndürmüyor?
Bu düğme, girdiğiniz anahtarla OpenAI alanının /v1/models yolunu çağırır. Dolayısıyla boş sonuç, Cherry Studio'dan ziyade o alanın adresine veya anahtara işaret eder. Her alan bir kök adres alır; sürümü ve yolu Cherry Studio kendisi ekler. Bu nedenle tam bir uç nokta URL'si (zaten /chat/completions ile biten bir URL) yapıştırmadığınızı kontrol edin, ardından aynı ikiliyi curl ile deneyin: JSON yanıtı sorunun uygulamada olduğunu, 401 ise anahtarın sorunlu olduğunu gösterir.
Cherry Studio'nun uç nokta alanının sonundaki # ne işe yarar?
Cherry Studio'nun kendi belgelerine göre bu karakter, yolu standart biçime uymayan uç noktalar için alanı sabit bir yola bağlar. Kunavo'nun OpenAI ve Anthropic uç noktalarının ikisi de standarttır; bu nedenle buna ihtiyacınız yoktur. Kendi /v1'iniz olsun veya olmasın, kök adresi girin ve kalanını Cherry Studio'nun eklemesine izin verin.
Cherry Studio, Anthropic hesabı olmadan Claude modellerini kullanabilir mi?
Evet, bir ağ geçidi bunları sunuyorsa. Kunavo adresini özellikle Anthropic alanına girin; OpenAI alanına değil. Cherry Agent ve Anthropic Messages protokolü üzerinden yönlendirilen tüm modeller bu alanı kullanır. Cherry Studio, model kimliğini sağlayıcı kaydında belirtilen uç noktaya gönderir; böylece Claude kimliği orada çözümlenir ve Cherry Studio'nun tuttuğu tek kimlik bilgisi, uç noktanın anahtarı olur.