Her katalog modelini Cherry Studio'ya tek bir sağlayıcı olarak ekleyin.

Updated 2026-07-29

Cherry Studio'nun Model Services ayarları herhangi bir OpenAI uyumlu endpoint'i kabul eder: OpenAI türünde bir sağlayıcı ekleyin, API adresini api.apisrouter.com olarak ayarlayın, tek bir anahtar yapıştırın ve model id'lerini elle ekleyin. Claude, GPT, DeepSeek, GLM, Kimi ve Qwen, masaüstünde tek bir seçicide otururlar.

Hızlı yanıt: Model Services'te tek bir sağlayıcı.

Cherry Studio'nun sol navigasyonundaki dişli simgesine tıklayın, Model Services sekmesini açın ve sağlayıcı listesinin altındaki Add düğmesine tıklayın. Sağlayıcıya tanınabilir bir ad verin (APIsRouter) ve sağlayıcı türü olarak OpenAI'yi seçin, ardından kaydedin. Şimdi listede yeni sağlayıcıyı seçin ve onu yapılandırın: etkinleştirme geçişini açın, anahtarınızı API anahtarı alanına yapıştırın ve API adresini https://api.apisrouter.com olarak ayarlayın. Şekle dikkat edin: Cherry Studio'nun belgelenmiş varsayılanı kök adresi almak ve /v1/chat/completions'ı kendisinin eklemesidir, bu yüzden host'u /v1 olmadan girersiniz. Ardından model bölümündeki Add düğmesiyle model ekleyin, girdi başına tam bir katalog id'si (claude-sonnet-4-6, deepseek-v4-flash, glm-5.2) ve seçilen bir modele karşı canlı bir doğrulama çalıştırmak için anahtarın yanındaki Check düğmesine basın.

Provider name:  APIsRouter
Provider type:  OpenAI

then, on the provider page:
API key:        sk-YOUR-APISROUTER-KEY
API address:    https://api.apisrouter.com
                (Cherry appends /v1/chat/completions)
Models → + Add: claude-sonnet-4-6, deepseek-v4-flash, glm-5.2
Check → pick a model → success

Cherry Studio istek URL'sini nasıl oluşturur.

Cherry Studio (GitHub'da CherryHQ, kabaca 49K yıldız), yüzlerce sağlayıcı ve asistan için önayarlar sunmasıyla tanınan, Çin kökenli Windows, macOS ve Linux için masaüstü istemcisidir. Önayar listesinde olmayan her şey yukarıdaki özel sağlayıcı akışından girer ve anlaşılmaya değer kısım API adresi alanıdır. Belgelenmiş varsayılan: kök adresi siz verirsiniz ve Cherry Studio OpenAI rotasını onun üzerine birleştirir, bu yüzden https://api.apisrouter.com telde https://api.apisrouter.com/v1/chat/completions olur. Bir sağlayıcı standart-dışı bir yol kullanıyorsa, adresi # ile bitirmek birleştirmeyi tamamen devre dışı bırakır ve adres tam olarak yazıldığı gibi kullanılır; bu, belgelenmiş bir kaçış yoludur. Sondaki eğik çizgiler etrafındaki birleştirme davranışı sürümler arasında kaymıştır, bu yüzden istekler 404 verirse tahmin etmek yerine hatadaki nihai URL'yi okuyun; kök-adres biçimi artı otomatik ekleme, standart bir /v1 gateway'i için kararlı yapılandırmadır. Yapılandırıldıktan sonra, her konuşma eklediğiniz model id'sini düz bir string olarak taşıyan standart chat completions gönderir. Satıcılar wire formatı için önemli değildir; bu, tek bir sağlayıcı girdisinin Çince ve Batılı katalog id'lerini birlikte taşımasına izin veren şeydir.

Karşılığını veren detaylar: çoklu-anahtar ve model yönetimi.

API anahtarı alanı birden fazla anahtarı kabul eder: anahtarları İngilizce virgülle ayırın ve Cherry Studio, belgelenmiş bir yük dengeleme özelliği olarak, istek başına üstten alta rotasyon yapar. Anahtar başına ölçen bir gateway ile bu, aynı zamanda atıf olarak da işlev görür: iş için bir anahtar, kişisel için bir anahtar, rotasyon yalnızca bir anahtar listeleyerek kapalı. Model girdileri elle yapılır ve bu bir özelliktir. Cherry Studio, tam olarak eklediğinizi gösterir, bu yüzden seçici, getirilen bir katalogda boğulmak yerine düzenlenmiş kalır. Her girdi id'yi wire dizesi olarak alır; Manage düğmesi girdileri sonradan düzenler veya kaldırır. İlgili id'leri tutarlı adlandırmayla gruplandırın ve seçici bir menü gibi okunur: hızlı katman (deepseek-v4-flash, claude-haiku-4-5-20251001), bölgesel güç (glm-5.2, qwen3.7-plus, kimi-k2.6), sınır (claude-sonnet-4-6). Check düğmesi, seçtiğiniz bir modele karşı anahtar ve adres çiftini doğrular ve sağlayıcıyı gerçek konuşmalardan önce doğrulamanın en hızlı yoludur. Doğru bir anahtarla başarısız bir kontrol neredeyse her zaman adres alanının yolu ikiye katlayan başıboş bir /v1 taşıdığı anlamına gelir.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# add these ids verbatim in the provider's model list

Masaüstü bir iş atı için model seçmek.

Tek bir anahtar, karşılaştırmaların seçici değişimleri olduğu anlamına gelir. Aynı işin bir haftasını iki aday id üzerinde çalıştırın ve APIsRouter konsolundaki model başına harcamanın kendi çıktı kalitesi okumanıza karşı hakemlik yapmasına izin verin.

  • Günlük sohbet ve hızlı yeniden yazımlar hızlı katmanda yaşar: deepseek-v4-flash ve claude-haiku-4-5-20251001, her zaman açık pencereyi ücretsiz hissettirmeye devam eder.
  • Çince dil işi, bölgesel id'lerin satırlarını hak ettiği yerdir: taslak ve belgeler için glm-5.2 ve qwen3.7-plus, uzun-bağlam okuma için kimi-k2.6.
  • claude-sonnet-4-6, değiştirmeden ilettiğiniz konuşmaları alır: dikkatli analiz, müşteriye dönük nesir, göndermeyi düşündüğünüz kod.
  • Cherry Studio'nun asistanları rol başına kendi modellerini sabitleyebilir, bu yüzden glm-5.2'de bir çeviri asistanı ve claude-sonnet-4-6'da bir kodlama asistanı tek bir sağlayıcının arkasında bir arada var olur.
  • Satırları kasıtlı olarak ekleyin; düzenlenmiş altı-model bir seçici kullanılır, yapıştırılmış bir katalog ise kaydırılıp geçilir.

Kullandıkça öde · resmi fiyatların altında

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ModelResmi FiyatBizim Fiyatımız
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
GLM-5.2$1.14 / $4.00 per M$1.10 / $4.00 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M
Qwen 3.7 Plus$0.29 / $1.14 per M$0.30 / $1.10 per M

Cherry Studio'ya özgü hata modları.

İkiye katlanmış yol en yaygın rapordur: /v1/chat/completions ekleyen bir alana https://api.apisrouter.com/v1 yapıştırmak, 404 veren /v1/v1 URL'leri üretir. Kök adresi girin ve istemcinin rotayı oluşturmasına izin verin. Tam bir URL'yi sabitlemeniz gerekiyorsa, bunun için sondaki # biçimi vardır. İyi bir anahtarla başarısız bir Check genellikle yukarıdaki adres şeklidir; temiz bir adresle başarısız bir Check anahtardır ve birden fazla anahtarın İngilizce virgüllerle ayrılması gerektiğini not edin, çünkü Çince girdi yöntemlerinden yapıştırılan tam genişlikli karakterler listeyi sessizce bozar. Diğerleri çalışırken bazı modellerin tek tek hata vermesi bir id-yazım sorunudur; girdiler serbest metindir ve /v1/models listesi yetkili kaynaktır. Ve ayarların makine başına olduğunu unutmayın: masaüstünüzde yapılandırılan bir sağlayıcı, iki dakikalık kurulumu tekrarlamadıkça veya Cherry Studio'nun kendi yedekleme özelliklerini kullanmadıkça dizüstünüzde var olmaz. Sürüm kayması notu: Cherry Studio sık dağıtım yapar ve ayar etiketleri hareket eder (Model Services bazı derlemelerde Model Provider olarak da görünmüştür); sağlayıcı ekleme, OpenAI türünü seçme, anahtar, adres, modeller akışı kararlı kalmıştır.

Cherry Studio'yu bir gateway üzerinden kim yönlendirir.

  • GLM, Qwen, Kimi ve DeepSeek'i Claude ve GPT ile tek bir seçicide, tek bir bakiyede, satıcı başına hesap olmadan karıştıran iki dilli masaüstü kullanıcıları.
  • Batılı bir kart olmadan, zaten kullandıkları bölgesel modellerin yanında ön ödemeli bir bakiyede Claude ve GPT id'leri isteyen Asya'daki kullanıcılar.
  • Beş anahtar yönetmeden her asistanı doğru satıcıya sabitlemek isteyen, rol başına Cherry Studio asistanları çalıştıran güç kullanıcıları.
  • Zaten diğer araçları bir gateway üzerinden yönlendiren ve masaüstü istemcisini aynı anahtar ve kullanım günlüğünde isteyen kişiler.
  • Her adayın bir model satırı olduğu, benchmark'lar yerine gerçek günlük işte bölgesel ve Batılı modelleri karşılaştıran herkes.

Endpoint'i doğrulayın ve ilk konuşmayı hata ayıklayın.

Önce model listesini curl'leyin ve eklemeyi planladığınız id'leri kopyalayın; ardından günlük sürücünüze karşı bir chat completion çalıştırın. İkisi de geçtiğinde, geriye kalan her şey sağlayıcı sayfasındadır. Cherry Studio içinde, sohbetten önce Check çalıştırın. Kimlik doğrulama başarısızlıkları anahtar alanı veya virgül ayırıcılarıdır. 404'ler adres şeklidir; hatadaki oluşturulmuş URL'yi okuyun ve /v1 segmentlerini sayın. Belirli bir modelde bulunamadı hataları, o satırdaki id yazımıdır. Konuşmalar akmaya başladığında, APIsRouter konsolu istek başına modeli, token sayılarını ve harcamayı gösterir. Bir iş günü boyunca kullanılan masaüstü bir istemci, sürekli bir küçük istek akışı üretir ve anahtar başına kullanım görünümü, o akışı Çince ve Batılı id'lerin aynı sayfada olduğu model başına, gün başına sayılara dönüştürür.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Sık sorulan sorular

Cherry Studio'ya özel bir sağlayıcıyı nasıl eklerim?

Dişli simgesi, Model Services sekmesi, Add. Sağlayıcıyı adlandırın, OpenAI türünü seçin, kaydedin, ardından sayfasında onu etkinleştirin, anahtarınızı yapıştırın, API adresini https://api.apisrouter.com olarak ayarlayın ve model id'lerini elle ekleyin. Check düğmesiyle doğrulayın.

API adresi /v1 içermeli mi?

Hayır. Cherry Studio'nun belgelenmiş varsayılanı kök adresi alır ve /v1/chat/completions'ı kendisi ekler, bu yüzden https://api.apisrouter.com girin. /v1'li bir host yapıştırmak yolu ikiye katlar ve 404 verir. Standart-dışı tam bir URL'yi sabitlemek için adresi # ile bitirerek birleştirmeyi devre dışı bırakın.

Cherry Studio, Claude, DeepSeek ve GLM'yi tek bir sağlayıcı üzerinden çalıştırabilir mi?

Evet. Her model satırının id'si adrese düz bir string olarak seyahat eder, bu yüzden claude-sonnet-4-6, deepseek-v4-flash, glm-5.2, kimi-k2.6 ve qwen3.7-plus tek bir sağlayıcı girdisini ve tek bir anahtarı paylaşabilir, konuşma başına ve asistan başına değiştirilebilir.

Virgülle ayrılmış anahtar özelliği ne yapar?

API anahtarı alanındaki, İngilizce virgüllerle ayrılmış birden fazla anahtar, isteklerde üstten alta rotasyona sokulur; bu, yerleşik bir yük dengeleme özelliğidir. Gateway tarafında anahtar başına ölçümle bu, aynı zamanda atıf olarak da işlev görür; rotasyonu kapalı tutmak için tek bir anahtar listeleyin.

Check düğmesi neden başarısız oluyor?

Doğru bir anahtarla, olağan neden, oluşturulmuş yolu ikiye katlayan başıboş bir /v1 taşıyan bir adrestir. Temiz bir adresle, anahtarı ve ayırıcılarını yeniden kontrol edin; Çince girdi yöntemlerinden gelen tam genişlikli virgüller, çoklu-anahtar listelerini sessizce bozar.

Modeller neden önayar sağlayıcılar gibi otomatik doldurulmuyor?

Özel sağlayıcılar tam olarak eklediğinizi listeler; Cherry Studio özel bir endpoint'in katalogunu getirmez. Bu, seçiciyi düzenlenmiş tutar. Id'leri /v1/models listesinden çekin ve gerçekten kullandıklarınızı ekleyin, ardından başka birine ihtiyaç duyduğunuz gün listeyi genişletin.