Bu belge, orijinal İngilizce metnin makine çevirisidir. Bu çeviri ile orijinal İngilizce sürüm arasında herhangi bir çelişki olması durumunda, İngilizce sürüm geçerli olacaktır. İngilizce orijinal metni oku

AI Sağlayıcıları ve API Anahtarları

Caiioo, küçük bir sağlayıcı seti aracılığıyla 500'den fazla AI modeline bağlanır. Kendi API anahtarınızı getirirsiniz — bu, sağlayıcıya doğrudan ödeme yaptığınız ve Caiioo'nun harcamalarınıza asla dokunmadığı anlamına gelir.

Desteklenen Sağlayıcılar

Bugün genel olarak yedi sağlayıcı kullanılabilmektedir:

  • OpenRouter (varsayılan) — tek bir anahtar; Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama ve daha fazlası dahil olmak üzere 500'den fazla modelin kilidini açar. Çoğu kullanıcı için önerilen yol budur; Caiioo'nun araçları OpenRouter'ın model kayıt defterini bekler ve yalnızca tek bir anahtarı yönetirsiniz.
  • Google AI — kendi Google AI anahtarınızla Gemini API'ye doğrudan bağlantı. Google gerçek bir ücretsiz kota sunar, bu nedenle bu, yerel düşünme ve 2M bağlama kadar özelliklerle son teknoloji bir modeli kredi kartı olmadan çalıştırmanın gerçek bir yoludur. Ayarlar, ücretsiz bir anahtar almanızı adım adım gösterir.
  • Anthropic — kendi Anthropic anahtarınızla Claude API'ye doğrudan bağlantı, araç kullanımıyla birlikte yerel genişletilmiş düşünme. console.anthropic.com adresinden bir anahtar oluşturun veya Claude hesabınıza erişimi onayladıktan sonra Caiioo'nun bir tane oluşturmasına izin verin. Anahtar, Anthropic Konsol hesabınıza faturalandırılır; Caiioo, onu oluşturmak için kullanılan Claude oturum açma bilgilerini saklamaz.
  • xAI (Grok) — api.x.ai aracılığıyla Grok modellerine doğrudan erişim. Bir xAI konsol API anahtarıyla bağlanın veya sadece Grok hesabınızla oturum açın (SuperGrok veya X Premium+ aboneliği) — tarayıcıda erişimi onaylayın ve kopyalanacak anahtar gerekmeden bağlanmış olursunuz. Not: xAI, kendi tarafında hesap ve abonelik katmanına göre API erişimini etkinleştirir; bağlandıktan sonra sohbetler bir izin hatasıyla başarısız olursa, bunun yerine bir xAI API anahtarı kullanın.
  • CometAPI — tek bir kullandıkça öde CometAPI anahtarı aracılığıyla 500+ model (GPT, Claude, Gemini, DeepSeek ve daha fazlası). Model seçici, kataloğu için kıyaslama (benchmark) düzeyinde madalyalar gösterir ve toplam CometAPI kullanımı Ayarlar'da izlenir.
  • Poe — jeton başına dolar yerine Poe aboneliğinizin puanları üzerinden faturalandırılan, tek bir Poe API anahtarı aracılığıyla Anthropic, Google, OpenAI, xAI, Meta ve diğerlerinden modeller. Kalan puan bakiye bakiyeniz ve bir iş parçacığının ne kadar harcadığı uygulamada görünür. poe.com/api/keys adresinden bir anahtar edinin.
  • Ollama — açık kaynaklı modelleri makinenizde yerel olarak çalıştırır. Tamamen gizli, internet gerektirmez, ücretsiz. Çevrimdışı çalışmak veya çıkarım (inference) üzerinde mutlak kontrol istiyorsanız yararlıdır. (Ollama Cloud, isteğe bağlı bir API anahtarıyla da çalışır.)

Diğer sağlayıcılara (OpenAI, MLX ve daha fazlası) yapılan doğrudan bağlantılar test aşamasındadır ve henüz genel olarak kullanıma sunulmamıştır. Şimdilik bu modelleri OpenRouter anahtarınız üzerinden kullanın — OpenRouter bunun içindir.

Politikalar için Kullanım Koşulları sayfasına bakın.

Başlayın (İki Seçenek)

Seçenek 1: Ücretsiz Sağlanan Anahtarı Kullanın

Caiioo'yu hemen denemenizi sağlayan ücretsiz bir OpenRouter anahtarı sağlıyoruz. Test etmek için mükemmel olan, kullanım limitlerine sahip seçili ücretsiz modellere erişimi vardır.

Kullanmaya devam etmek için: sadece Caiioo'yu açın ve sohbet etmeye başlayın. Kurulum gerekmez. Pro aboneleri, mevcut bakiyeye ek olarak bu aynı anahtara otomatik olarak uygulanan ek bir aylık 5$ OpenRouter kredi bonusu alır.

Dahil edilen anahtarı kullanırken, Ayarlar'daki OpenRouter anahtar alanı boş görünmek yerine bunu belirtir — Caiioo'nun hesap anahtarını ve kalan bakiyenizi kullandığınıza dair bir not görürsünüz. Anahtarlarınız cihazınızda saklanır; Özel Senkronizasyon (Private Sync) açıkken, hem dahil edilen anahtar hem de kendi OpenRouter anahtarınız, şifrelenmiş yedeğinizin içinde diğer cihazlarınıza taşınır.

Kredi tüketen araçlar — görsel, video ve müzik üretimi, gelişmiş OCR ve Perplexity AI araması — yalnızca bir anahtar değil, OpenRouter kredileri gerektirir. Ücretsiz sağlanan anahtarda bu araçlar "kredi yok" bildirir. İlerlemek için iki yolunuz var: Ayarlar > Yapay Zeka Kurulumu > Yapay Zeka Sağlayıcısı bölümünden kendi OpenRouter API anahtarınızı girin (BYOK) veya Caiioo planınızı yükseltin — ücretli bir plan her ay bu aynı sağlanan anahtara kredi yükler, böylece bu araçlar doğrudan çalışır.

Seçenek 2: Kendi Anahtarınızı Getirin (BYOK)

Ücretsiz katman limitleri olmadan tam erişim ister misiniz? Kendi anahtarınızı ekleyin.

OpenRouter (önerilen):

  1. openrouter.ai adresinden kaydolun ve bir API anahtarı oluşturun
  2. Ayarlar → Yapay Zeka Kurulumu → Yapay Zeka Sağlayıcısı bölümüne gidin
  3. OpenRouter'ı seçin ve anahtarınızı yapıştırın — veya hiçbir şeyi kopyalamadan hesabınızı bağlamak için OpenRouter ile Oturum Aç seçeneğine tıklayın
  4. Bu kadar — anahtar cihazınızda kalır ve asla Caiioo'nun sunucularına ulaşmaz

Google AI (doğrudan Gemini):

  1. Ayarlar → Yapay Zeka Kurulumu → Yapay Zeka Sağlayıcısı bölümüne gidin ve Google AI'ı seçin
  2. Kılavuzlu "ücretsiz anahtarınızı alın" adımlarını takip edin (Google AI Studio, kredi kartı gerektirmeden ücretsiz anahtar verir)
  3. Anahtarı yapıştırın — cihazınızda kalır ve istekler doğrudan Google'a gider

Anthropic (doğrudan Claude):

  1. Ayarlar → Yapay Zeka Kurulumu → Yapay Zeka Sağlayıcısı bölümüne gidin ve Anthropic'i seçin
  2. Anthropic kimlik bilgileri (Anthropic credentials) yanındaki Yönet (Manage) öğesine tıklayın
  3. Bağlı Hesaplar (Connected Accounts) altında, Claude hesabınızdan bir anahtar oluşturun (Create a key from your Claude account) seçeneğine tıklayın
  4. Tarayıcıda erişimi onaylayın, yetkilendirme kodunu tekrar Caiioo'ya yapıştırın ve Bağlan (Connect) seçeneğine tıklayın

Ayrıca API anahtarı ekle (Add API key) seçeneğine tıklayıp Anthropic Konsolu'nda oluşturduğunuz bir anahtarı yapıştırabilirsiniz.

Poe:

  1. Ayarlar → Yapay Zeka Kurulumu → Yapay Zeka Sağlayıcısı bölümüne gidin ve Poe'yu seçin
  2. poe.com/api/keys adresinden bir anahtar oluşturun — anahtar alanının altındaki not da bunu göstermektedir
  3. Anahtarı Poe API Anahtarı (Poe API Key) alanına yapıştırın

Puan bakiye durumunuz anahtarın altında görünür. Sohbet maliyetleri hem Poe puanı hem de dolar cinsinden görünür.

Ollama (yerel):

  1. ollama.com adresinden Ollama'yı yükleyin ve bir model çekin (ollama pull llama3.2)
  2. Ayarlar → Yapay Zeka Kurulumu → Yapay Zeka Sağlayıcısı bölümüne gidin
  3. Ollama'yı seçin ve sunucu URL'sini onaylayın (varsayılan http://localhost:11434)
  4. Yerel olarak yüklediğiniz herhangi bir modeli seçin

Yerel bir sohbet modeli seçtiğinizde, verilerinizi uzaktaki bir yapay zeka sağlayıcısına gönderen yapay zeka destekli araçlar önce onayınızı ister. Bkz. Gizlilik ve Veriler → Uzaktan Yapay Zeka Sağlayıcıları (Remote AI Providers).

Varsayılan Model ve Maksimum Adımları gösteren Model Yapılandırması

Hızlı Görevler Modeli

Caiioo'nun başlık oluşturma, niyeti sınıflandırma, hangi aracın çağrılacağını seçme ve diğer kısa yardımcı sorgular gibi şeyler için arka planda otomatik olarak kullandığı ayrı, daha ucuz bir model — buna asla doğrudan komut vermezsiniz. Ayarlar → Yapay Zeka Kurulumu → Model Yapılandırması bölümünden yapılandırın (küçük bir OpenRouter ücretsiz modeli veya yerel bir Ollama modeli fazlasıyla yeterlidir). Ayarlanmazsa, sistem varsayılan modelinize geri döner.

Araçlar İçin Kendi Kimlik Doğrulamanızı Getirin (BYOA) — Pro

BYOA, BYOK'den farklıdır. LLM'ler için değil, araç bağlantıları (Google Workspace, Microsoft 365, GitHub vb.) içindir. Pro'da, Ayarlar → Hesap → Hesap Yetkilendirmeleri ve İzinleri, kuruluşunuz Caiioo'nun varsayılan istemci kimliğini beyaz listeye almadığında kendi OAuth istemcinizi eklemenize olanak tanır:

  • Kendi Google OAuth Uygulamanızı Kullanın — bir Google Cloud projesi oluşturma ve istemci kimliği + gizli anahtarını yapıştırma adımlarından geçin
  • Kendi Microsoft Azure Uygulamanızı Kullanın — Azure'a kayıtlı uygulamalar için aynı akış
  • Özel OAuth Sağlayıcısı Ekle — bunu destekleyen herhangi bir sağlayıcı için genel OAuth 2.0 akışı

Sihirbazlar, kimlik bilgilerini doğrudan Kimlik Bilgileri Kasası'na (Credentials Vault) yazar. Asla cihazınızdan ayrılmazlar.

Sağlayıcı Başına Birden Fazla Hesap veya Anahtar Tutun

Her sağlayıcı birden fazla kimlik bilgisi tutabilir — kişisel olanın yanında bir iş anahtarı veya bir API anahtarının yanında oturum açmış bir hesap — bunlardan biri aynı anda kullanımdadır. Artık bir anahtarın üzerine yazıp daha sonra tekrar yapıştırmaya son.

Bunları Ayarlar > Hesap > Hesap Yetkilendirmeleri ve İzinleri altında, Yapay Zeka Sağlayıcı Hesapları (Bağlı Hesaplar ve API Anahtarları sekmeleriyle birlikte) altında yönetin — veya Ayarlar > Yapay Zeka Kurulumu > Yapay Zeka Sağlayıcısı bölümünde sağlayıcının yanındaki Yönet seçeneğine tıklayın. Her kimlik bilgisine bir ad verebilirsiniz (örn. "İş"), aktif olan bir Kullanımda rozeti taşır ve geçiş yapmak Kullan düğmesine tek tıklamaktır. Caiioo'dan bir kimlik bilgisini kaldırmak sağlayıcı tarafında hiçbir şeyi iptal etmez — oradaki hesabınız dokunulmaz kalır ve daha sonra tekrar ekleyebilirsiniz.

API Anahtarı Güvenliği

API anahtarlarınız cihazınızda yerel olarak saklanır. Özel Senkronizasyon (Private Sync) açıkken, anahtarlarınız ve bağlı sağlayıcı hesaplarınız senkronizasyon yedeğinize girmeden önce cihazınızda şifrelenir, ardından yalnızca diğer cihazlarınızda şifresi çözülür. Caiioo sunucuları asla okunabilir kimlik bilgileri almaz. Bir istek yaptığınızda, konuşmayı çalıştıran cihaz kendi aktif kimlik bilgisini doğrudan yapay zeka sağlayıcısına gönderir. Ayrıntılar için Gizlilik ve Veriler bölümüne bakın.

Performans Modelinize Bağlıdır

Caiioo orkestrasyonu yönetir — araçlar, bağlam, çok adımlı iş akışları. Ancak yapay zekanın yanıtlarının kalitesi, hangi modeli seçtiğinize bağlıdır.

Karmaşık görevler için (araştırma, analiz, uzun belgeler): bir frontier model kullanın — Claude Sonnet, GPT-class veya Gemini Pro — hepsi OpenRouter anahtarınız aracılığıyla erişilebilirdir. Çok adımlı akıl yürütme ve araç kullanımını en iyi onlar yönetir.

Hızlı yanıtlar için (sorular, özetler, basit düzenlemeler): hızlı modeller — Claude Haiku, daha küçük GPT veya Gemini Flash varyantları — daha ucuz ve daha hızlıdır. Günlük görevler için mükemmeldir.

Denemeler yapmak için: OpenRouter, tek bir API anahtarıyla 500'den fazla modeli denemenize olanak tanır. Tek bir sağlayıcıya bağlı kalmadan iş akışınız için en iyi olanı bulun.

Model seçici, her bir modele fiilen hizmet veren sağlayıcının yeteneklerini açıklar ve ölçümlerin mevcut olduğu durumlarda benchmark madalyalarını gösterir. Yeni yayımlanan veya ölçülmemiş bir model görünür kalmaya devam eder; yalnızca henüz madalya taşımaz. Toplam maliyetlerde hizmet veren sağlayıcının yayımlanmış tarifeleri kullanılır; Caiioo bir tarife belirleyemezse, tahmin yürütmek yerine maliyeti hariç tutar.

İki madalya, iki farklı soru. Bir model, biri veya her ikisi için de altın, gümüş ya da bronz madalya taşıyabilir:

  • Best for Caiioo, yalnızca yeteneğe göre sıralama yapar. Fiyat bunun bir parçası değildir; bu nedenle ucuz ve hızlı bir model, en iyiler sütununun başında yer alamaz.
  • Value for Caiioo, fiyatın devreye girdiği yerdir — maliyetine göre elde edebileceğiniz en iyi kalite.

Otomatik yönlendirme de aynı ayrımı takip eder: Value Router maliyeti hesaba katar, diğer yönlendiriciler ise katmaz. Seçicide gördüğünüz kriterler, uygulamanın fiilen seçim yaparken kullandığı kriterlerdir.

Madalyaların arkasındaki ölçümleri görün. Model Intelligence (Caiioo Benchmarks, Pro); kaliteyi, veri çıkış hızını (throughput), ilk belirtece kadar geçen süreyi (time-to-first-token), araç doğruluğunu ve fiyatlandırmayı karşılaştırır ve metodolojiyi — her bir sayının nereden geldiğini ve değer puanına nelerin dahil edildiğini — ayrıntılarıyla açıklar. Her bir görev türü için sıralamalar bir kez yayımlanır ve hem uygulama hem de caiioo.ai üzerindeki liderlik tablosu tarafından okunur; bu sayede yönlendirmenin seçtiği ile liderlik tablosunun gösterdiği şey aynıdır. Liderlik tablosu, yalnızca genel durumu değil, kodlama, araştırma veya yazma alanlarında hangi modelin lider olduğunu görmek istemeniz durumunda bir Best by Use Case dökümü de sunar.

Creativity kaydırıcısı hakkında bir not: En yeni modeller (Claude Sonnet 5 ve sonrası gibi) kendi yaratıcılıklarını kendileri yönetir ve bir temperature ayarı kabul etmez. Bunlardan birini seçtiğinizde, Model Configuration bölümündeki Creativity kaydırıcısı kısa bir notla devre dışı bırakılır — bu beklenen bir durumdur, bir hata değildir.

Çevrimdışı / tamamen gizli çalışmalar için: Ollama, açık kaynaklı modelleri makinenizde çalıştırır. Bulut tabanlı frontier modellerden daha yavaştır, ancak donanımınızın dışına hiçbir şey çıkmaz.

Caiioo'nun araçları, bağlam katmanları ve orkestrasyonu, seçtiğiniz model hangisi olursa olsun onu güçlendirir. İyi bir model, birlikte çalışacağı doğru bağlama ve araçlara sahip olduğunda harika bir modele dönüşür.

Ayrıca Bakınız

This guide is maintained by the Caiioo team using Slate, our built-in editor.