Cherry Studio API kurulumu

Cherry Studio API kurulumu arayanların çoğu bir özellik listesi değil, çalışan bir bağlantı ister: hangi Provider seçilecek, API key nereye yazılacak, Base URL ne olacak ve model listesi neden görünmüyor?

Kısa yol: Ayarlar → Model Services → Provider seç veya ekle → API bilgilerini gir → modeli al veya elle ekle → Provider'ı etkinleştir → Check.

Cherry Studio; OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot, Ollama ve LM Studio için hazır Provider'lar sunar. Gateway, özel sunucu veya OpenAI uyumlu bir servis için resmî özel Provider kılavuzunu izleyin.

Başlamadan önce

Servis sağlayıcınızdan şu dört bilgiyi alın:

Web sitesindeki giriş parolası API key değildir. ChatGPT aboneliği, API hesabı ve üçüncü taraf gateway farklı erişim yollarıdır.

GPT'yi Cherry Studio'ya bağlama

1. Model Services sayfasını açın

Cherry Studio'da Settings → Model Services yolunu açın. OpenAI'yi doğrudan kullanıyorsanız yerleşik OpenAI Provider'ı seçin. Gateway veya özel bir servis için Add Provider ile ayrı bir kayıt oluşturun.

Provider, model adındaki “GPT” kelimesine göre değil, API protokolüne göre seçilir.

2. Alanları doldurun

OpenAI uyumlu servislerde genellikle kök adres girilir ve istemci yolu ekler. Örneğin https://api.example.com ile https://api.example.com/v1/chat/completions birlikte gösteriliyorsa, ilk adres normal Base URL'dir. Tam yolu sadece sağlayıcı özellikle istiyorsa kullanın.

3. Modeli alın veya elle ekleyin

Get model list düğmesine basın ve + ile modeli ekleyin. Sunucunun döndürdüğü gerçek ID'yi kullanın; tarih, sağlayıcı öneki ve sürüm eklerini değiştirmeyin.

Model keşfi yoksa ID'yi elle ekleyin. Provider'ı sağ üstten açın; aksi halde model sohbet seçicisinde görünmez.

4. Kısa bir istekle test edin

Check ile modeli seçin ve şu mesajı gönderin:

Yalnızca şunu yazın: bağlantı başarılı

Önce metin yanıtını doğrulayın. Görsel, araç ve reasoning özelliklerini daha sonra tek tek test edin.

Üçüncü taraf API ve yerel modeller

OpenAI uyumlu bir gateway için özel Provider içinde OpenAI protokolünü kullanın. Bir gateway OpenAI Chat, Responses, Anthropic ve Gemini yollarını aynı kök adreste sunuyorsa NewAPI yapılandırma kılavuzuna bakın. Ollama, LM Studio veya vLLM için yerel Provider'ı ya da OpenAI uyumlu özel Provider'ı seçin ve sunucunun gerçekten yüklediği model adını girin.

Model listesi boşsa

Şu sırayla kontrol edin:

1. Servis gerçekten model keşfi sağlıyor mu? Bazı API'ler yalnızca belirtilen model ID'sini kabul eder.
2. /v1 veya /chat/completions yolu iki kez eklenmiş mi?
3. API adresi yerine yönetim paneli adresi mi yazıldı?
4. Model ID'si karakter karakter doğru mu?
5. Provider etkin mi?

Her seferinde tek bir değişkeni değiştirin: bir Provider, bir model ve kısa bir istek.

OmniaKey ile tek giriş

GPT, Claude, Gemini ve diğer modeller için tek bir OpenAI uyumlu Provider kullanmak isterseniz OmniaKey'i Cherry Studio'ya ekleyebilirsiniz:

1. API Keys sayfasından Cherry Studio'ya özel bir key oluşturun.
2. Cherry Studio'da Settings → Model Services → Add Provider yolunu açın.
3. URL ve kimlik doğrulama biçimi için OmniaKey hızlı başlangıç sayfasını izleyin.
4. Güncel model kataloğundan gerçek ID'yi ekleyip kısa bir istek çalıştırın.

Katalogdaki model ID'leri ve yetenekler değişebilir. OpenAI uyumluluğu, bütün modellerin vision veya tools özelliklerini aynı şekilde desteklediği anlamına gelmez.

Sık sorulanlar

Her API URL'si çalışır mı?

Hayır. Sağlayıcının desteklediği protokolü, kimlik doğrulamayı ve model ID'sini belgelediğinden emin olun.

ChatGPT web hesabını API key olarak kullanabilir miyim?

Web giriş bilgilerini API key alanına yazmayın. Cherry Studio API yetkisi veya uyumlu gateway anahtarı ister.

GPT ile sohbet çalışıyor ama Agent çalışmıyor. Neden?

Metin yanıtı yalnızca temel rotayı doğrular. Modeli, protokolü ve tools desteğini ayrı ayrı kontrol edin.