Tek bir providers.yaml ile Raycast AI'ye katalog modelleri koyun.

Hızlı yanıt: Custom Providers'ı etkinleştirin, bir dosyayı düzenleyin.

Raycast'in OpenAI-compatible endpoint'ler için yolu, ileri düzey kullanıcıları hedefleyen ve varsayılan olarak devre dışı olan Custom Providers özelliğidir. Raycast Settings'te AI bölümünün altında etkinleştirin, config klasörünü açmak için Reveal Providers Config'i kullanın ve birlikte gelen providers.template.yaml'ı providers.yaml olarak kopyalayın. Dosya ~/.config/raycast/ai/providers.yaml'da yaşar. Her sağlayıcı girdisi bir id, bir görünen ad, bir base_url ve bir api_keys bloğu alır; seçicide istediğiniz her model, id'si, görünen adı ve bağlam penceresiyle artı Raycast'in ondan isteyebileceklerini açıklayan bir abilities bloğuyla açıkça beyan edilir. base_url şekli, /v1 köküne işaret eden yerleşik yerel-model örnekleriyle aynı kuralı izler, bu yüzden APIsRouter'ın değeri https://api.apisrouter.com/v1'dir. Dosya kimlik bilgileri tuttuğundan, onu herhangi bir sır dosyası gibi ele alın.

providers:
  - id: apisrouter
    name: APIsRouter
    base_url: https://api.apisrouter.com/v1
    api_keys:
      default: sk-APIsRouter-...
    models:
      - id: claude-sonnet-4-6
        name: Claude Sonnet 4.6
        context: 200000
        abilities:
          temperature:
            supported: true
          tools:
            supported: true
      - id: claude-haiku-4-5-20251001
        name: Claude Haiku 4.5
        context: 200000
        abilities:
          temperature:
            supported: true

Benzer görünen ama öyle olmayan iki Raycast özelliği.

Raycast, kendi AI erişiminizi getirmenin iki yolunu belgeler ve birini aramak güvenilir şekilde diğerini yüzeye çıkarır, bu yüzden ayrım açıkça belirtilmeye değer. Bring Your Own Keys, Raycast kılavuzundaki BYOK sayfası, kişisel Anthropic, Google veya OpenAI anahtarınızı (iOS'ta OpenRouter) Raycast AI'ye bağlar. Daha basit özelliktir, Pro aboneliği olmadan çalıştığı belgelenmiştir, ama özel bir endpoint değildir: istekler API birleştirme için Raycast'in sunucuları üzerinden yönlenir ve kılavuz yalnızca Raycast AI'de zaten mevcut olan modellerin erişilebilir olduğu konusunda açıktır. Bir gateway anahtarı orada takılmaz, çünkü BYOK asla bir URL istemez. Custom Providers, bu sayfanın yapılandırdığı özelliktir: kendi base_url'iniz, kendi anahtarınız, kendi beyan ettiğiniz modelleriniz, istekler onları işaret ettiğiniz yere gider. Bu, çok satıcılı bir gateway için, yerel sunucular için ve Raycast'in yerleşik listesinin taşımadığı herhangi bir model için yoldur. Karşılığı açıklıktır; Raycast sizin için endpoint'in model listesini çekmez (bu kolaylık bekleyen bir özellik talebidir), bu yüzden seçici tam olarak YAML'ınızın beyan ettiğini gösterir, ne fazlası ne eksiği.

Modelleri dürüstçe beyan etmek: id'ler, bağlam, yetenekler.

Otomatik keşif olmadığından, YAML bir sözleşmedir ve içindeki her alan gerçek bir iş yapar. Model id'si gateway'in /v1/models listelemesiyle tam olarak eşleşmelidir; istekte taşınan şey odur. name yalnızca Raycast'in gösterdiği etikettir. context değeri, Raycast'e bir isteğe ne kadar konuşma geçmişi paketleyebileceğini söyler, bu yüzden onu olduğundan az göstermek yeteneği israf eder, olduğundan fazla göstermek ise modelin reddettiği istekler üretir; beyan ettiğiniz id için belgelenmiş pencereyi kullanın. abilities bloğu insanların yanlış anladığı kısımdır. Raycast'in her modelden ne bekleyebileceğini beyan eder: sıcaklık kontrolü, görsel girdi, sistem mesajları, tool kullanımı, muhakeme çabası. Modelin sahip olmadığı bir yeteneği beyan etmek, temiz hatalar yerine Raycast özellikleri içinde kafa karıştırıcı çalışma zamanı hatalarına neden olur ve modelin sahip olduğu gerçek bir yeteneği atlamak, karşılık gelen Raycast davranışını sessizce devre dışı bırakır. Minimal başlayın, kullanacağınız modeller için sıcaklık artı tools, ve modelin belgelerine karşı onayladıkça yetenekler ekleyin. Bu dosyayı bir UI'dan yönetmek için özel olarak var olan topluluk bakımlı bir Raycast eklentisi var, her değişiklikten önce otomatik yedeklemelerle; elle YAML tercihiniz değilse bilinmeye değer. Ne olursa olsun, Raycast dosyayı diskten okur, bu yüzden düzenledikten sonra AI ayarlarına bir an verin veya seçicinin geçerli dosyayı yansıttığından emin olmak için özelliği açıp kapatın.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# declare these ids verbatim in providers.yaml

Bir launcher için model seçmek.

Beyan edilen her model aynı anahtar üzerinden faturalandığından, karşılaştırma döngüsü bir seçici geçişidir: aynı hızlı komutları bir gün boyunca iki id'de çalıştırın, ardından konsoldaki model başına harcamayı okuyun ve yerini hak edeni tutun.

• Launcher AI patlama işidir: bunu özetle, şunu yeniden yaz, seçimi açıkla. claude-haiku-4-5-20251001 ve gemini-3.5-flash, pencere animasyonu bitmeden önce döner, ki bu Raycast kullanıcılarının beklediği histir.
• AI Chat oturumları ve uzun taslaklar, claude-sonnet-4-6 veya gpt-5.5'i hak eder; onları hızlı katmanın yanında beyan edin ve seçicide görev başına geçiş yapın.
• Tool çağıran AI eklentileri, güvenilir tool kullanımına sahip bir model ve buna eşleşecek şekilde beyan edilmiş abilities bloğu ister; claude-sonnet-4-6 orada güvenli ilk seçimdir.
• deepseek-v4-flash, AI'ı dokundukları her metin alanına kablolayan kullanıcılar için hacim seçimidir; sabit küçük tamamlamalar birikir ve hızlı katman alışkanlığı bakiyede görünmez kılar.
• Az sayıda modeli spekülatif değil kasıtlı olarak beyan edin: her girdi, üzerinden kaydırdığınız bir seçici satırıdır ve YAML, başka bir id'ye ihtiyaç duyduğunuz gün genişletmesi kolaydır.

Kullandıkça öde · resmi fiyatların altında

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Raycast'e özgü hata modları.

Custom Providers kastederken BYOK yapılandırmak en üstteki hatadır ve bu sizin hatanız değildir: özellikler bir arama alanını paylaşır. İçinde bulunduğunuz akış bir satıcı anahtarı istiyor ama asla bir URL istemiyorsa, BYOK'tasınızdır ve gateway oraya ait değildir. Settings, AI ve alttaki Custom Providers geçişine geri dönün. Dosyanın yok sayılması genellikle özellik geçişinin kapalı olduğu, dosyanın hâlâ providers.template.yaml olarak adlandırıldığı veya YAML'da bir sözdizimi hatası olduğu anlamına gelir, bu durumda Raycast'in yükleyecek geçerli hiçbir şeyi yoktur ve seçici basitçe hiçbir özel model göstermez. Daha derin bir şeyden şüphelenmeden önce YAML'ı doğrulayın. Bazı Raycast özelliklerinde hata veren ama diğerlerinde vermeyen bir model, bir yetenekler uyuşmazlığıdır: tools yeteneğinden yoksun bir modelde beyan edildiğinde düz sohbet çalışırken tool kullanan AI eklentileri başarısız olur veya sahip olan bir modelde asla beyan edilmediğinde. Boyut için reddedilen istekler, olduğundan fazla gösterilen bir context değerine işaret eder. Ve platform sınırını dürüstçe not edin: Custom Providers, Mac'te, yerel bir config dosyasında yapılandırılır. Raycast kullanımınızın bir kısmı başka bir yerdeyse, parite için özelliğin orada neyi desteklediğini varsaymadan önce kılavuzu kontrol edin.

Raycast AI'yi bir gateway üzerinden kim yönlendirir.

• Launcher'da yaşayan ve hangi modellere dokunabileceklerine bir aboneliğin karar vermesi olmadan hızlı AI komutlarını hızlı katalog id'lerinde isteyen güçlü kullanıcılar.
• Zaten editörlerini ve terminal araçlarını bir gateway üzerinden yönlendiren ve launcher'ı aynı anahtarda, her yüzey genelinde tek bir kullanım logunda isteyen kişiler.
• Raycast'in yerleşik listesinin taşımadığı modelleri, DeepSeek ve GLM id'leri dahil, YAML'da bir kez beyan edilmiş ve uygulamanın her yerinde mevcut isteyen kullanıcılar.
• Eklentilerinin arkasında belirli bir tool-yetenekli modele ihtiyaç duyan, barındırılan bir liste yerine id ile sabitlenmiş AI-eklenti geliştiricileri.
• Belirli bir satıcının faturalandırmasına erişimi olmayan geliştiriciler. Kart gerektirmeyen yükleme tabanlı erişim, sağlayıcı başına kayıt bağımlılığını ortadan kaldırır.

Endpoint'i doğrulayın ve ilk komutu hata ayıklayın.

Önce modelleri curl'leyin ve çıktısından YAML'a id'leri kopyalayın; id'leri bellekten yazmak buradaki model-not-found hatalarının başlıca nedenidir, çünkü dosya Raycast'in sahip olduğu tek model kaynağıdır. Ardından geçişi etkinleştirin, seçicinin beyan ettiğiniz adları gösterdiğini doğrulayın ve hızlı model üzerinde bir hızlı AI komutu çalıştırın. Boş bir seçici, geçiş, dosya adı veya YAML sözdizimidir. Bir kimlik doğrulama hatası api_keys bloğudur. Bir not-found hatası, az önce curl'lediğiniz listelemeye karşı bir id uyuşmazlığıdır. Sohbette çalışan ama bir AI eklentisinde başarısız olan bir komut, o modeldeki abilities beyanıdır. Komutlar akmaya başladığında, APIsRouter konsolu istek başına modeli, token sayılarını ve harcamayı gösterir. Launcher AI, birkaç büyük istek yerine yüzlerce küçük istektir ve kullanım logu, bu deseni bir rakama dönüştürdüğü, model başına, gün başına, gateway üzerinden yönlendirdiğiniz her diğer aracın aynı sayfasında olduğu yerdir.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Sık sorulan sorular