Cherry Studio'yu CheapTokens'a bağlayın: özel sağlayıcı, Base URL

CheapTokens'u Cherry Studio'da kullanmak için özel bir sağlayıcı ekleyin (Ayarlar → Model Sağlayıcı → Sağlayıcı Ekle), OpenAI Base URL alanına https://api.cheaptokens.dev/v1/ yazın, API anahtarınızı yapıştırın ve deepseek-ai/DeepSeek-V4-Flash-0731 model kimliğini elle ekleyin. Ardından Model Check ile anahtarı doğrulayın ve bir merhaba deyin. İşin tamamı bu; tek can sıkıcı ayrıntı URL'nin sonundaki eğik çizgi.

Bir masaüstü sohbet uygulaması açarsınız çünkü birden fazla model için tek pencere ve arkalarında tek bakiye istersiniz, her servis için ayrı bir tarayıcı sekmesi değil. Cherry Studio tam bunun için tasarlanmıştır: Windows, macOS ve Linux için açık kaynaklı bir yapay zeka çalışma istasyonudur (AGPL-3.0 Community Edition); sohbet, ajanlar ve bilgi tabanları içerir ve OpenAI uyumlu herhangi bir servisi özel sağlayıcı olarak kabul eder. CheapTokens, OpenAI Chat Completions formatını konuşur, dolayısıyla uyum sağlar. Aşağıdaki adımlar Cherry Studio'nun özel sağlayıcılar hakkındaki doküman sayfasını izler, 7 Kasım 2026'da kontrol edilmiştir; uygulamanın kendisi değişir, bu yüzden bir etiket taşınmışsa yakınlarda aynı kelimeyi arayın.

Uygulamayı açmadan önce neye ihtiyacınız var#

Üç şey, hepsi kısa:

• Base URL: https://api.cheaptokens.dev/v1/ (sondaki eğik çizgiyle — nedeni bir sonraki bölümde);
• CheapTokens hesabınızdan bir API anahtarı, kopyalayabileceğiniz bir yerde tutun, paylaşılan bir nota yapıştırmayın;
• tam model kimliği. Fiyat listesindeki kısa ad API tarafından kabul edilmez; ağ geçidi kimliğini kullanın, örneğin deepseek-ai/DeepSeek-V4-Flash-0731. Diğer kimlikler list-models kılavuzunda ve CheapTokens dokümanlarında bulunur.

Özel sağlayıcıyı ekleyin#

Ayarlar'ı (dişli simgesi) açın, ardından Model Sağlayıcı'yı. Sağlayıcı listesinin altında + Sağlayıcı Ekle bulunur. Tıklayın ve Özel Sağlayıcı Ekle iletişim kutusu görünür.

Şu şekilde doldurun:

Cherry Studio varsayılan olarak 'OpenAI' ve 'Anthropic' uç nokta alanlarını gösterir. Yalnızca gerçekten kullandığınız protokolü doldurun; normal bir sohbet için bu OpenAI alanıdır ve Anthropic alanı boş kalabilir. Her Base URL alanının altında uygulama, nihai istek yolunun bir önizlemesini gösterir. Okuyun. Bir şey göndermeden önce yanlış bir adresi yakalamanın en hızlı yolu budur.

Kaydetmek için Ekle'ye tıklayın.

Sondaki eğik çizgi neden önemli#

Cherry Studio, istek URL'sini Base URL'nizden dokümanlarındaki üç kurala göre oluşturur (7 Kasım 2026'da kontrol edildi):

• https://example.com gibi bir kök adrese /v1/chat/completions eklenir;
• / ile biten bir adrese yalnızca chat/completions eklenir;
• # ile biten bir adres tam yazıldığı gibi kullanılır, hiçbir şey eklenmez.

CheapTokens /v1 altında bulunur, dolayısıyla https://api.cheaptokens.dev/v1/, https://api.cheaptokens.dev/v1/chat/completions haline gelen formdur — API'nin beklediği yol. Alanın altındaki önizleme tam olarak bunu göstermelidir. /v1/v1/ görüyorsanız veya hiç /v1 yoksa, devam etmeden önce alanı düzeltin.

Anahtar, model ve Model Check#

Sağlayıcının sayfasına döndüğünüzde beş küçük adım vardır. Bunları şu sırayla yapın:

5. adım hakkında bir not. Sayfada ayrıca servisten bir model listesi çeken bir Modelleri senkronize et düğmesi vardır. Güvenilir yol, kimliği + ile kendiniz eklemektir: deepseek-ai/DeepSeek-V4-Flash-0731 tam olarak, deepseek-ai/ kısmıyla birlikte yazın. Hangi modelleri ekleyebilirsiniz:

Model Check, anahtar alanının yanındaki düğmedir; Cherry Studio dokümanlarına göre anahtarın geçerli olduğunu kontrol eder. Şikayet ederse aşağıdaki hata bölümüne atlayın: neden genellikle üç alandan biridir.

İlk mesajı gönderin#

Yeni bir sohbet açın, üstteki model seçiciden CheapTokens sağlayıcısını ve eklediğiniz modeli seçin ve kısa bir şey yazın, örneğin 'Bir token'ın ne olduğunu iki cümleyle açıkla.' Modelden gelen bir yanıt, tüm zincirin çalıştığı anlamına gelir: anahtar, adres, model kimliği.

Bir isteği uygulama olmadan görmek ister misiniz? İşte düz bir Chat Completions çağrısı:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

Yanıt, metni choices[0].message.content içinde ve token sayılarını usage içinde taşıyan JSON'dur.

Masaüstü sohbete hangi model konmalı#

Bir sohbet penceresi, bir ajan döngüsünden farklı bir iştir: sorarsınız, okursunuz, tekrar sorarsınız. O zaman iki şey önemlidir: yanıtların ne kadar uzun olabileceği ve ne kadar büyük bir konuşmanın sığdığı.

• DeepSeek-V4-Flash — genel sohbet ve uzun belgeler için varsayılan tercih: yanıt başına 32.768 çıktı token'ına kadar, 380K bağlam, her saatte tek fiyat. Toplamda, girdi ve çıktı birlikte sayıldığında, OpenRouter'dan daha ucuz.
• GLM-5.3-Flash — üçünün en büyük penceresiyle (390K) günlük sohbet, hem girdide hem çıktıda OpenRouter'dan daha ucuz.
• MiniMax-M2.7 — 180K bağlamla sohbet ve ajan tarzı görevler, her iki tarafta da OpenRouter'dan daha ucuz.

Üçü de tek bir bakiyenin arkasında durur, böylece üç kimliği de aynı sağlayıcıya ekleyebilir ve anahtara dokunmadan model seçicide geçiş yapabilirsiniz.

Bir sohbet oturumunun maliyeti#

İşte kabaca bir tablo. Diyelim ki 20 mesajlık bir konuşmanız var. Her mesaj önceki geçmişi yeniden gönderir, bu yüzden bir istek ortalama yaklaşık 6.000 girdi token'ı ve 500 çıktı token'ı tutar (nedeni uzun bir sohbetin neden daha pahalı olduğu yazısında ele alınmıştır). DeepSeek-V4-Flash üzerinde bir istek $0.00014 tutar. Bunlardan yirmisi aşağıdaki hesaplayıcıda; kendi sohbetlerinize uydurmak için kaydırıcıları hareket ettirin.

Aşağıdaki tablo aynı oturumu tüm modellerde çalıştırır, karşılaştırma için bir OpenRouter sütunuyla:

1M token başına güncel fiyatlar için CheapTokens fiyatlandırmasına bakın.

Çalışmazsa#

Sorunların çoğu aynı üç alandan gelir: anahtar, URL, model kimliği. Gördüğünüzü nedene eşleştirin:

Bu hataların daha uzun bir anlatımı için API 401 veya 404: yanlış anahtar, base URL veya model kimliği yazısına bakın. Ve masaüstü uygulama yerine tarayıcı tabanlı bir sohbeti tercih ederseniz, Open WebUI aynı şekilde çalışır.

Kaynaklar: Cherry Studio dokümanları, özel sağlayıcı ve sağlayıcı ayarları sayfaları, 7 Kasım 2026'da kontrol edildi; proje github.com/CherryHQ/cherry-studio adresinde.