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 Settings > AI Setup > AI Provider bölümünde on bir bulut ve yerel sağlayıcı mevcuttur:

  • OpenRouter (varsayılan) — tek bir anahtar Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama, DeepSeek, Qwen ve daha fazlası dahil 500'den fazla modelin kilidini açar. Çoğu kullanıcı için önerilen yöntem budur — Caiioo'nun araçları OpenRouter'ın model dizinini bekler ve yalnızca tek bir anahtarı yönetirsiniz.
  • Google AI — kendi Google AI anahtarınızla Gemini API'ye doğrudan bir bağlantı. Google gerçek bir ücretsiz kota sunar; bu sayede yerel düşünme ve 2M'ye kadar bağlam ile öncü bir modeli çalıştırmanın kredi kartı gerektirmeyen gerçek bir yoludur. Settings, ücretsiz bir anahtar alma sürecinde size adım adım rehberlik eder.
  • Anthropic — araç kullanımının yanı sıra yerel genişletilmiş düşünme özelliğine sahip, kendi Anthropic anahtarınızla Claude API'ye doğrudan bir bağlantı. console.anthropic.com adresinden bir anahtar oluşturun veya Claude hesabınıza erişimi onayladıktan sonra Caiioo'nun bir anahtar oluşturmasına izin verin. Anahtar, Anthropic Console hesabınıza faturalandırılır; Caiioo, anahtarı oluşturmak için kullanılan Claude oturum açma bilgilerini saklamaz. Anthropic, bir Claude Pro veya Max aboneliğinin başka uygulamalarda kullanılmasına izin vermez; bu nedenle Caiioo'daki Claude, aboneliğiniz üzerinden değil, bir Console anahtarı üzerinden veya OpenRouter aracılığıyla çalışır.
  • xAI (Grok) — api.x.ai aracılığıyla Grok modellerine doğrudan erişim. Bir xAI konsol API anahtarıyla bağlanın veya Grok hesabınızla giriş yapın (SuperGrok veya X Premium+ aboneliği) — tarayıcıda erişimi onaylayın ve kopyalanacak bir anahtar olmadan doğrudan bağlanın. Not: xAI, API erişimini kendi tarafında hesap ve abonelik katmanına göre etkinleştirir; bağlantı kurulduktan sonra sohbetler bir izin hatasıyla başarısız olursa, bunun yerine bir xAI API anahtarı kullanın.
  • OpenAI — kendi OpenAI API anahtarınızla OpenAI modellerine doğrudan bir bağlantı veya ChatGPT hesabınızla giriş yapın; Caiioo bir anahtar yerine ChatGPT aboneliğiniz üzerinden çalışır.
  • CometAPI — kullandıkça öde yöntemli tek bir CometAPI anahtarı aracılığıyla 500'den fazla model (GPT, Claude, Gemini, DeepSeek ve daha fazlası). Model seçici, kataloğu için kıyaslama katmanı (benchmark-tier) madalyalarını gösterir ve toplam CometAPI kullanımı Settings içinde takip edilir.
  • Poe — token başına dolar yerine Poe aboneliğinizin puanlarıyla faturalandırılan, tek bir Poe API anahtarı aracılığıyla Anthropic, Google, OpenAI, xAI, Meta ve diğerlerinden modeller. Kalan puan bakiyeniz ve bir ileti dizisinin harcadığı miktar uygulamada gösterilir. poe.com/api/keys adresinden bir anahtar edinin.
  • Ollama — açık kaynaklı modelleri makinenizde yerel olarak çalıştırır (varsayılan olarak http://localhost:11434). Gizlidir, internet gerektirmez, ücretsizdir. Ollama Cloud da isteğe bağlı bir API anahtarıyla çalışır.
  • vLLM, Unsloth ve MLX (Pro) — isteğe bağlı bir taşıyıcı belirteç (bearer token) ile vLLM (varsayılan olarak http://localhost:8000), Unsloth (varsayılan olarak http://localhost:8000) veya MLX (Apple Silicon üzerinde varsayılan olarak http://localhost:8080) çalıştıran yerel ya da ağdaki OpenAI uyumlu çıkarım sunucularını bağlayın. Telefonunuzdan veya tarayıcınızdan masaüstünüzde barındırılan bir sohbete katıldığınızda, Caiioo söz konusu masaüstünün yerel sunucusundaki modelleri otomatik olarak listeler ve çalıştırır.

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

Başlarken (İki Seçenek)

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

Caiioo'yu hemen denemenizi sağlayan ücretsiz bir OpenRouter anahtarı sunuyoruz. Kullanım sınırları bulunan belirli ücretsiz modellere erişim sağlar — sistemi test etmek için mükemmeldir.

Kullanmaya devam etmek için: Caiioo'yu açıp sohbete başlamanız yeterlidir. Herhangi bir kuruluma gerek yoktur. Pro aboneleri, mevcut bakiyelerine ek olarak bu anahtara otomatik uygulanan aylık $5/ay OpenRouter kredi bonusu kazanır.

Dahili anahtarı kullanırken, Ayarlar'daki OpenRouter anahtarı alanı boş görünmek yerine bu durumu belirtir — Caiioo'nun hesap anahtarını kullandığınıza dair bir not ve kalan bakiyenizi görürsünüz. Anahtarlarınız cihazınızda saklanır; Private Sync açık olduğunda hem dahili anahtar hem de kendi OpenRouter anahtarınız şifreli yedeklemenizin içinde diğer cihazlarınıza aktarılır.

Kredi tüketen araçlar—görsel, video ve müzik üretimi, gelişmiş OCR ve Perplexity AI araması—yalnızca bir anahtara değil, OpenRouter kredisine ihtiyaç duyar. Ücretsiz sağlanan anahtarda bu araçlar "kredi yok" uyarısı verir. İlerlemek için iki seçeneğiniz vardır: Ayarlar > AI Setup > AI Provider bölümünden kendi OpenRouter API anahtarınızı girin (BYOK) veya Caiioo planınızı yükseltin—ücretli bir plan, sağlanan bu anahtara her ay kredi yükler, böylece bu araçlar sorunsuz bir şekilde çalışır.

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

Ücretsiz katman sınırları olmadan tam erişim mi istiyorsunuz? Kendi anahtarınızı ekleyin.

OpenRouter (önerilen):

  1. openrouter.ai adresinden kaydolun ve bir API anahtarı oluşturun
  2. Ayarlar → AI Setup → AI Provider bölümüne gidin
  3. OpenRouter'ı seçin ve anahtarınızı yapıştırın — ya da hiçbir şey kopyalamadan hesabınızı bağlamak için Sign in with OpenRouter seçeneğine tıklayın
  4. Bu kadar — anahtar cihazınızda kalır ve Caiioo'nun sunucularına asla ulaşmaz

Google AI (doğrudan Gemini):

  1. Ayarlar → AI Setup → AI Provider bölümüne gidin ve Google AI'ı seçin
  2. Yönlendirmeli "ücretsiz anahtarınızı alın" adımlarını takip edin (Google AI Studio anahtarları ücretsiz sağlar, kredi kartı gerekmez)
  3. Anahtarı yapıştırın — anahtar cihazınızda kalır ve istekler doğrudan Google'a gider

Anthropic (doğrudan Claude):

  1. Ayarlar → AI Setup → AI Provider bölümüne gidin ve Anthropic'i seçin
  2. Anthropic credentials yanındaki Manage öğesine tıklayın
  3. 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 Connect butonuna tıklayın

Ayrıca Add API key seçeneğine tıklayarak Anthropic Console'da oluşturduğunuz bir anahtarı da yapıştırabilirsiniz.

Poe:

  1. Ayarlar → AI Setup → AI Provider bölümüne gidin ve Poe'yu seçin
  2. poe.com/api/keys adresinde bir anahtar oluşturun — anahtar alanının altındaki not da burayı gösterir
  3. Anahtarı Poe API Key alanına yapıştırın

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

Ollama, vLLM, Unsloth veya MLX (yerel ve ağ sunucuları):

  1. Yerel model sunucunuzu başlatın (http://localhost:11434 adresinde Ollama, http://localhost:8000 adresinde vLLM veya Unsloth ya da http://localhost:8080 adresinde MLX)
  2. Ayarlar > AI Setup > AI Provider bölümüne gidin
  3. Ollama, vLLM, Unsloth veya MLX seçeneğini belirleyin, sunucu URL'sini (ve ağınızdaki uzak sunucular için isteğe bağlı API anahtarı/token'ını) onaylayın ve ana makineniz tarafından sunulan herhangi bir modeli seçin

Yerel bir sohbet modeli seçtiğinizde, verilerinizi uzak bir AI sağlayıcısına gönderecek olan AI destekli araçlar önce onayınızı isteyebilir. Bkz. Gizlilik ve Veri → Başka Bir AI Sağlayıcısı Kullanan Araçlar.

Default Model ve Max Steps ayarlarını gösteren Model Yapılandırması

Tek Caiioo Router ve Efor Kontrolü

Ayrı yönlendirici modları arasında seçim yapmak veya bir göreve hangi modelin uyduğunu tahmin etmek yerine, Caiioo Router ve Efor'u kullanmak için yazma alanındaki model seçiciyi (veya Ayarlar > Yapay Zeka Kurulumu > Model Yapılandırması) açın:

  • Caiioo Router: İki canlı kaydırıcıyı ortaya çıkarmak için model seçicinin üst kısmındaki Caiioo Router'ı seçin:
    • Maliyet ↔ Zeka — hızlı ve uygun maliyetli günlük sıralar için En düşük maliyet, en iyi fiyat-performans kalitesi için Dengeli veya öncü akıl yürütme için En yüksek zeka yönüne kaydırın.
    • Halüsinasyon önleme — doğruluk en çok önem taşıdığında olgusal temellendirmeyi ve alıntı disiplinini daha yüksek ağırlıklandırın.
    • Her iki kaydırıcıyı hareket ettirdikçe alttaki model listesi yerinde filtrelenir ve tercihlerinizle eşleşen modelleri görebilmeniz için yeniden sıralanır.
  • Efor kontrolü: Seçilen bir model (veya Caiioo Router) akıl yürütme eforunu desteklediğinde, model seçicide doğrudan bir Efor kontrolü görünür. Otomatik'i seçin (veya modelin desteklediğine bağlı olarak Kapalı, Düşük, Orta, Yüksek, Maks). Caiioo Router, sabit bir varsayılan kabul etmek yerine modelleri sohbetin seçtiği efor seviyesinde sıralar ve seçer.

Hızlı Görevler Modeli

Caiioo'nun dizi başlıkları 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 işlemler için arka planda otomatik olarak kullandığı ayrı ve daha ucuz bir modeldir; buna asla doğrudan istem göndermezsiniz. 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 BYOA (Kendi Kimlik Doğrulamanı Getir) — Pro

BYOA, BYOK'tan farklıdır. LLM'ler için değil, araç bağlantıları (Google Workspace, Microsoft 365, GitHub vb.) içindir. Pro'da, kuruluşunuz Caiioo'nun varsayılan istemci kimliğini izin verilenler listesine almadığında Ayarlar → Bağlayıcılar → Ekle → Kendi OAuth uygulamanız kendi OAuth istemcinizi bağlamanızı sağlar:

  • Kendi Google OAuth Uygulamanızı Kullanın — bir Google Cloud projesi oluşturma ve istemci kimliği + gizli anahtarı yapıştırma adımlarını takip edin
  • 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 cihazınıza kaydeder. Cihazınızdan asla ayrılmazlar.

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

Her sağlayıcı birden fazla kimlik bilgisi barındırabilir — kişisel bir anahtarın yanında iş anahtarı veya bir API anahtarının yanında oturum açılmış bir hesap — ve aynı anda bunlardan biri kullanımda olur. Artık bir anahtarın üzerine yazıp daha sonra tekrar yapıştırmakla uğraşmanıza gerek yok.

Bunları Ayarlar > Bağlayıcılar bölümünden yönetin: her sağlayıcı Yapay Zekâ modeli türünde bir satırdır ve tıklandığında hesapları ve anahtarları listelenir. Veya Ayarlar > Yapay Zekâ Kurulumu > Yapay Zekâ 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. "İş"), etkin olan bir Kullanımda rozeti taşır ve geçiş yapmak Kullan seçeneğine tek bir tıklamadır. Bir kimlik bilgisini Caiioo'dan kaldırmak sağlayıcı tarafında hiçbir şeyi iptal etmez — oradaki hesabınıza dokunulmaz 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; araçlar, bağlam ve çok adımlı iş akışları gibi orkestrasyon süreçlerini üstlenir. 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 aracılığıyla erişilebilen Claude Sonnet, GPT sınıfı veya Gemini Pro gibi bir öncü model kullanın. Çok adımlı akıl yürütme ve araç kullanımını en iyi bu modeller yönetir.

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

Deneme 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 kıyaslama (benchmark) madalyalarını gösterir. Yeni çıkan veya henüz ölçülmemiş bir model görünür kalmaya devam eder; yalnızca henüz madalyası bulunmaz. Toplam maliyetler, hizmeti sunan sağlayıcının yayınlanan tarifelerini kullanır; Caiioo bir tarife belirleyemezse, tahmin yürütmek yerine maliyeti dahil etmez.

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

  • Best for Caiioo yalnızca yeteneğe göre sıralama yapar. Fiyat buna dahil değildir, bu nedenle ucuz ve hızlı bir model en iyi adlı sütunun başında yer alamaz.
  • Value for Caiioo ise fiyatın devreye girdiği yerdir; maliyetine göre elde edebileceğiniz en iyi kaliteyi ifade eder.

Caiioo Router doğrudan bu kıyaslama ölçümlerini kullanır: İbreyi Balanced veya Lowest cost yönüne kaydırmak kaliteyle birlikte fiyatı da gözetirken, Highest intelligence yönüne kaydırmak yeteneğe öncelik verir. 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 belirteç süresini (time-to-first-token), araç doğruluğunu ve fiyatlandırmayı karşılaştırır; her bir sayının nereden geldiğini ve değer puanına nelerin dahil edildiğini gösteren metodolojiyi açıklar. Her bir görev türüne ait sıralamalar bir kez yayınlanı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 tamamen aynıdır. Liderlik tablosu, yalnızca genel durumu değil; kodlama, araştırma veya yazma alanlarında hangi modelin önde olduğunu görmek istemeniz durumunda bir Best by Use Case dökümü 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ı 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 not ile 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ı öncü modellere göre daha yavaştır, ancak hiçbir veri donanımınızın dışına çıkmaz.

Caiioo'nun araçları, bağlam katmanları ve orkestrasyonu, seçtiğiniz modeli daha da 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.