# Cherry Studio API kurulumu > Cherry Studio'ya GPT, OpenAI uyumlu API, Claude, Gemini veya yerel model bağlayın. Provider, API key, Base URL, model ID ve 401/404 hatalarını adım adım inceleyin. - Canonical HTML: https://omniakey.com/tr/blog/cherry-studio-api-setup - Markdown: https://omniakey.com/tr/blog/cherry-studio-api-setup.md - Published: 2026-09-17 (updated 2026-09-21) - Author: Kiki, COO at OmniaKey - Language: tr - Category: API setup - Reading time: 12 min - All posts: https://omniakey.com/blog/llms.txt --- **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](https://docs.cherryai.com.cn/pre-basic/providers/zi-ding-yi-fu-wu-shang.md) izleyin. ## Başlamadan önce Servis sağlayıcınızdan şu dört bilgiyi alın: |Bilgi|Açıklama| |-|-| |Protokol|OpenAI-compatible, Anthropic Messages, Gemini veya belgelenen başka bir format| |API key|İsteği doğrulayan gizli anahtar| |Base URL|Genellikle API'nin kök adresi| |Model ID|Sunucunun kabul ettiği tam model adı| 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 |Alan|Ne girilmeli|Sık hata| |-|-|-| |Provider adı|Bu bağlantıyı tanıyacağınız bir etiket|Farklı adreslerde aynı etiketi kullanmak| |API key|Yalnızca key değeri|Boşluk, tırnak veya `Bearer` eklemek| |API type|Sağlayıcının belgelediği protokol|Model adına bakarak tahmin etmek| |API address|Kök URL veya açıkça istenen tam URL|Yönetim paneli adresi ya da iki kez `/v1`| 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: ```text 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](https://docs.cherryai.com.cn/pre-basic/providers/newapi.md) 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? |Hata|İlk kontrol| |-|-| |`401`|API key, protokol ve boşluklar| |`403`|Yetki, bakiye veya key limiti| |`404`|Kök URL ve protokol yolu| |`400`|Özel parametreleri kaldırıp kısa metin deneyin| |`model not found`|Gerçek model ID'si ve Cherry Studio listesi| |Metin çalışıyor, görsel/tools çalışmıyor|Model ve protokol yetenekleri| 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](https://omniakey.com/tr/dashboard/tokens) 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ıç](https://docs.omniakey.com/tr/quick-start) sayfasını izleyin. 4. [Güncel model kataloğundan](https://omniakey.com/tr/models) gerçek ID'yi ekleyip kısa bir istek çalıştırın. 5. Provider'ı etkinleştirin, kısa bir kontrol çalıştırın ve isteği [Kullanım](https://omniakey.com/tr/dashboard/usage) sayfasında doğrulayı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. Aynı anahtar diğer araçlarda da çalışır; [WorkBuddy özel model kurulumu](https://omniakey.com/tr/blog/workbuddy-custom-model-setup), [Cline'da özel API anahtarı](https://omniakey.com/tr/blog/cline-custom-api-key) ve [Claude Code'u OmniaKey ile kullanma](https://omniakey.com/tr/blog/claude-code-setup) kılavuzlarına bakın. ## 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. ### Kök URL mi, `/chat/completions` mı girilmeli? Sağlayıcının dokümanını izleyin. Genellikle kök URL girilir ve istek yolunu Cherry Studio ekler; tam adresi yalnızca sağlayıcı açıkça istiyorsa kullanın. ### 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. ## Kontrol edilen kaynaklar - [Cherry Studio: Model hizmeti ayarları](https://docs.cherryai.com.cn/pre-basic/providers/providers.md) - [Cherry Studio: Özel Provider](https://docs.cherryai.com.cn/pre-basic/providers/zi-ding-yi-fu-wu-shang.md) - [Cherry Studio: NewAPI](https://docs.cherryai.com.cn/pre-basic/providers/newapi.md) - [Cherry Studio: Çoklu model karşılaştırması ve mesaj dalları](https://docs.cherryai.com.cn/advanced-basic/chat/model-compare-branches.md) Model ID'leri, Provider yetenekleri ve istek adresleri gibi teknik değerler değişebilir; yapılandırma sırasında bunları yeniden kontrol edin.