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 beş sağlayıcı kullanılabilmektedir:

  • OpenRouter (varsayılan) — tek bir anahtar; Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama ve daha fazlasını içeren 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, yerel düşünme yeteneği ve 2M bağlama kadar sınırıyla, bir sınır modelini kredi kartı gerektirmeden çalıştırmanın gerçek bir yoludur. Ayarlar bölümü size ücretsiz bir anahtar almanızda rehberlik eder.

  • xAI (Grok) — api.x.ai aracılığıyla Grok modellerine doğrudan erişim. Bir xAI konsol API anahtarıyla bağlanın veya basitçe Grok hesabınızla oturum açın (SuperGrok veya X Premium+ aboneliği) — tarayıcıda erişimi onaylayın ve bağlanmış olursunuz, kopyalanacak anahtar gerekmez. Not: xAI, API erişimini kendi tarafında hesap ve abonelik katmanına göre etkinleştirir; bağlandıktan sonra sohbetler 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ı üzerinden 500'den fazla model (GPT, Claude, Gemini, DeepSeek ve daha fazlası). Model seçici, kataloğu için kıyaslama kademesi madalyalarını gösterir ve toplam CometAPI kullanımı Ayarlar'da izlenir.

  • Ollama — açık kaynaklı modelleri yerel olarak makinenizde çalıştırır. Tamamen gizlidir, internet gerektirmez, ücretsizdir. Çevrimdışı çalışmak veya çıkarım üzerinde mutlak kontrol istemek için kullanışlıdır. (Ollama Cloud ayrıca isteğe bağlı bir API anahtarıyla da çalışır.)

Diğer sağlayıcılara (Anthropic, OpenAI, Poe, MLX ve daha fazlası) 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çin vardır.

Politikalar için Kullanım Koşulları bölümüne bakın.

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

Seçenek 1: Ücretsiz Tahsis Edilmiş Anahtarı Kullanın

Caiioo'yu hemen denemenizi sağlayan ücretsiz bir OpenRouter anahtarı sağlıyoruz. Kullanım limitleriyle birlikte seçili ücretsiz modellere erişim sunar — işleri test etmek için mükemmeldir.

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

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. Dahil edilen anahtar, onu kurduğunuz cihazda kalır; kendi OpenRouter anahtarınız da cihaz başına depolanır ve yalnızca Özel Senkronizasyon'u açtıktan sonra diğer cihazlarda görünürmüş.

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 tahsis edilen anahtarda bu araçlar "kredi yok" bildirir. İlerlemek için iki yolunuz var: Ayarlar > Yapay Zeka Sağlayıcıları kısmına kendi OpenRouter API anahtarınızı girin (BYOK) veya Caiioo planınızı yükseltin — ücretli bir plan, bu aynı tahsis edilmiş anahtara her ay 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 Sağlayıcısı bölümüne gidin
  3. OpenRouter seçeneğini seçin ve anahtarınızı yapıştırın — veya hiçbir şey 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 Sağlayıcısı bölümüne gidin ve Google AI seçeneğini seçin
  2. Rehberli "ücretsiz anahtarınızı alın" adımlarını takip edin (Google AI Studio ücretsiz anahtarlar verir, kredi kartı gerekmez)
  3. Anahtarı yapıştırın — cihazınızda kalır ve istekler doğrudan Google'a gider

Ollama (yerel):

  1. ollama.com adresinden Ollama'yı yükleyin ve bir model çekin (ollama pull llama3.2)
  2. Ayarlar → Yapay Zeka Sağlayıcısı bölümüne gidin
  3. Ollama seçeneğini 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 uzak bir yapay zeka sağlayıcısına gönderecek yapay zeka destekli araçlar öncelikle onayınızı ister. Bkz. Gizlilik ve Veri → Uzak Yapay Zeka Sağlayıcıları.

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

Hızlı Görevler Modeli

Caiioo'nun konuşma başlıkları oluşturma, niyet 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 arkada otomatik olarak kullandığı ayrı, daha ucuz bir model — buna doğrudan asla komut vermezsiniz. Ayarlar → 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 BYOA (Kendi Kimlik Doğrulamanı Getir) — 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 bağlamanıza 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ını izleyin
  • Kendi Microsoft Azure Uygulamanızı Kullanın — Azure'da kaydedilmiş 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 çıkmazlar.

API Anahtarı Güvenliği

API anahtarlarınız cihazınızda yerel olarak saklanır. Asla Caiioo sunucularına gönderilmezler. Bir istekte bulunduğunuzda, anahtarınız doğrudan AI sağlayıcısına gider. Hikayenin tamamı için Gizlilik ve Veri bölümüne bakın.

Performans Modelinize Bağırdır

Caiioo organizasyonu 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): OpenRouter anahtarınız üzerinden erişilebilen bir sınır (frontier) modeli kullanın; Claude Sonnet, GPT sınıfı veya Gemini Pro. Çok adımlı akıl yürütme ve araç kullanımını en iyi şekilde yönetirler.

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.

Deneme yaparken: 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 uygun olanı bulun.

Yaratıcılık kaydırıcısı hakkında bir not: en yeni modeller (Claude Sonnet 5 ve sonrası gibi) kendi yaratıcılıklarını yönetir ve sıcaklık (temperature) ayarını kabul etmez. Bunlardan birini seçtiğinizde, Model Yapılandırmasındaki Yaratıcılık kaydırıcısı kısa bir notla devre dışı bırakılır — bu bir hata değil, beklenen bir durumdur.

Çevrimdışı / tamamen gizli çalışma için: Ollama, makinenizde açık kaynaklı modeller çalıştırır. Bulut sınır modellerinden daha yavaştır, ancak donanımınızdan hiçbir şey dışarı çıkmaz.

Caiioo'nun araçları, bağlam katmanları ve orkestrasyonu, hangi modeli seçerseniz seçin onu güçlendirir. İyi bir model, birlikte çalışacak doğru bağlama ve araçlara sahip olduğunda harika hale gelir.

Ayrıca Bakınız

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