Raycast’in yapay zeka özellikleri artık providers.yaml özel sağlayıcısı aracılığıyla OpenAI ile uyumlu herhangi bir sağlayıcıyı bağlamanıza olanak tanıyor. CometAPI, yüzlerce modeli OpenAI tarzı bir REST arayüzü arkasında sunan bir ağ geçidi API’sidir — böylece Raycast’i https://api.cometapi.com/v1 adresine yönlendirebilir, CometAPI anahtarınızı ekleyebilir ve Raycast AI içinde CometAPI modellerini (sohbet, komutlar, uzantılar) kullanabilirsiniz.
Raycast nedir?
Raycast, komutları, betikleri ve — giderek artan şekilde — yapay zekayı doğrudan işletim sisteminize entegre eden macOS için bir verimlilik başlatıcısıdır. Yapay zeka alt sistemi sohbet, yapay zeka komutları, model seçimi, uzantılar (LLM’lerin eylemler gerçekleştirmesine olanak tanıyan araçlar) ve yerel modelleri (Ollama aracılığıyla) veya uzak model sağlayıcılarına bağlanmak için Kendi Anahtarını Getir / Özel Sağlayıcılar’ı kullanma yeteneğini sağlar. Raycast bir model seçici, yapay zeka ayarları ve OpenAI ile uyumlu arka uçlar eklemek için gelişmiş kullanıcıların özelleştirebileceği bir providers.yaml şablonu sunar.
Raycast, 2025’te BYOK (Bring Your Own Key) ve Özel Sağlayıcıları kullanıma sunarak kullanıcıların Raycast AI’ı kendi API anahtarları ve özel uç noktalarıyla çalıştırmasını (daha esnek maliyet yönetimi ve özel sağlayıcı seçenekleri) mümkün kılıyor. Bu değişiklik, CometAPI’nin son kullanıcı Raycast tercihleri üzerinden entegre edilmesini mümkün kılan teknik temeldir.
Raycast yapay zekayı kullanıcılara nasıl sunuyor?
- Quick AI: başlatıcıdan anında istemler.
- AI Chat: ekler/bağlamla sohbet oturumları.
- AI Commands/Extensions: LLM’leri kullanan geliştirici yapımı komutlar veya araçlar.
(Modelleri, BYOK anahtarlarını ve özel sağlayıcıları Ayarlar → AI bölümünden yönetebilirsiniz.)
CometAPI nedir?
CometAPI, yüzlerce farklı yapay zeka modelini (metin, görsel, ses, video, embedding’ler) tek bir, OpenAI tarzı REST arayüzü üzerinden sunan bir API toplama platformudur. OpenAI, Anthropic, Google, Midjourney, Runway vb. için sağlayıcıya özgü istemci kodu yazıp bakımını yapmak yerine, CometAPI uç noktasını çağırır ve istediğiniz modeli bir model dizesiyle seçersiniz. Bu sadeleştirme denemeler, maliyet/kesinti yönlendirmesi ve faturalama ile gözlemlenebilirliği merkezileştirme için güçlüdür.
Temel yetenekler
- Metin/sohbet tamamlamaları ve asistanlar (OpenAI benzeri sohbet API’leri).
- Görsel üretimi ve görsel düzenleme uç noktaları.
- Anlamsal arama/RAG (retrieval-augmented generation) için embedding’ler.
- Ses (alttaki modeller sağladığında TTS ve STT).
- Özel arka uçlar için video üretimi (Sora, Veo vb.).
CometAPI ayrıca SDK kod parçacıkları ve OpenAI tarzı istek biçimleri sağlar; böylece mevcut kodu taşımak kolaydır.
Neden şu anda önemli: pazar, tek uç noktalı kullanım kolaylığı, daha ucuz seçenekler ve model seçimi sunan ağ geçidi API’lerine doğru kayıyor. CometAPI bu alandaki ticari oyunculardan biridir; bunu Raycast’in özel sağlayıcı desteğiyle birleştirmek, macOS iş akışınızdan geniş bir model kataloğuna anında erişim sağlar.
Neden CometAPI’yi Raycast ile entegre etmelisiniz?
Kısa cevap: CometAPI’nin sunduğu herhangi bir modeli, araçlar arasında geçiş yapmadan doğrudan Raycast AI akışınızdan — Quick AI, AI Chat veya özel AI komutları — çalıştırmak için.
Faydalar:
- Raycast içinde kalırken farklı görevler (özetler, kod, embedding’ler, görsel üretimi) için daha ucuz/daha hızlı veya uzmanlaşmış modelleri kullanın.
- Modelleri Raycast’ten seçerken faturalama ve hız sınırlamayı CometAPI üzerinden merkezileştirin.
- Minimum kod değişikliği: Raycast, OpenAI ile uyumlu özel sağlayıcıları ve BYOK’u destekler; bu nedenle CometAPI çoğunlukla yalnızca
base_urlve API anahtarını değiştirerek entegre olur.
(Bu yetenekler, Raycast’in özel sağlayıcıları ve BYOK’u desteklemesi ve CometAPI’nin OpenAI ile uyumlu uç noktaları https://api.cometapi.com/v1. adresinde sunması sayesinde mümkündür.)
Bu entegrasyon için iyi kullanım örnekleri nelerdir?
- Developer helper: kod açıklamaları, yeniden düzenleme önerileri, birim test üretimi ve PR özetleme — Raycast’ten çağırın ve satır içi yanıtlar alın.
- Notes and summaries: metin seçin, CometAPI özetleme modelini kullanarak özetlemek veya eylem maddelerini çıkarmak için bir Raycast komutu çalıştırın.
- Documentation authoring: Raycast AI komutlarıyla fonksiyon dokümanları veya README parçacıkları üretin ve iterasyonları yerelde tutun.
- Image / multimedia generation: CometAPI görsel uç noktaları sunuyorsa, görsel uç noktalarını çağıran Raycast uzantılarını (ör. “Generate Image from Prompt” uzantısı) kullanabilirsiniz — hızlı taslaklar için kullanışlıdır.
- Embeddings + semantic search: yerel arama iş akışlarını güçlendirmek için CometAPI embedding’lerini kullanın — Raycast, küçük bir yerel betik veya bir bulut işlevi aracılığıyla embedding indeksinizi sorgulayan ön yüz olabilir.
Hangi ortam ve koşullar hazırlanmalı?
Başlamadan önce aşağıdakilerin hazır olduğundan emin olun:
Sistem ve Raycast
- macOS (Raycast macOS yerlisidir).
- Raycast kurulu olmalı. Özel Sağlayıcılar / BYOK’u destekleyen güncel bir sürüm tercih edin (Raycast BYOK’u v1.100.0’da ekledi ve Özel Sağlayıcıları sunmaya devam ediyor). Raycast’iniz eskiyse güncelleyin.
Hesaplar ve anahtarlar
- CometAPI hesabı ve geçerli bir CometAPI API anahtarı (bunu Raycast ayarlarında veya ortam değişkenlerinde kullanacaksınız). CometAPI paneli/dokümantasyonuna bakın.
İsteğe bağlı geliştirici araçları (test veya yerel geliştirme için)
- Terminal (cURL için).
- CometAPI erişimini Raycast’e bağlamadan önce doğrudan test etmek isterseniz Python / Node / OpenAI SDK’ları. CometAPI,
base_url’ü değiştirerek standart SDK’lar üzerinden doğrudan kullanım destekler.
İzinler ve ağ
- Raycast’in ve macOS ağ ilkelerinizin
api.cometapi.comadresine HTTPS çağrılarına izin verdiğinden emin olun. - Proxy/güvenlik duvarının bulunduğu kurumsal bir ortamdaysanız
api.cometapi.comadresinin erişilebilir olduğunu doğrulayın.
Yerel dosyalar ve konumlar
Raycast’in AI sağlayıcı yapılandırması, Raycast’in yapılandırma dizinindeki bir providers.yaml içinde bulunur (uygulama kopyalayabileceğiniz bir sağlayıcı şablonunu gösterebilir). Özel sağlayıcıları tanımlamak için providers.yaml dosyasını düzenleyecek veya oluşturacaksınız.
Raycast’i CometAPI ile nasıl entegre ederim?
Temel fikir: CometAPI’yi Raycast’te OpenAI ile uyumlu özel bir sağlayıcı olarak kaydedin, Raycast’i https://api.cometapi.com/v1 adresine yönlendirin ve Comet belirtecinizi Raycast’in özel API anahtarlarına ekleyin.
Adım 1: CometAPI anahtarınızı alın
- CometAPI’ye kaydolun ve konsolu/paneli açın.
- Bir API belirteci oluşturun. Bu belirteci güvenli bir yere kopyalayın (veya sonraki adım için elinizde tutun).
Adım 2: Raycast’in AI ayarlarını açın ve özel sağlayıcıları etkinleştirin
- Raycast içinde:
Preferences→AI. - “Custom Providers” (veya “Custom OpenAI-compatible APIs”) bölümünü bulun ve Reveal Providers Config’e tıklayın. Raycast, yapılandırma dizinini Finder’da açar ve
providers.template.yaml(genellikle) adlı bir şablon dosyası sağlar; bunu kopyalayıpproviders.yamlolarak yeniden adlandırın.
Adım 3: providers.yaml içine bir CometAPI sağlayıcısı ekleyin
providers.yaml dosyasını oluşturun veya düzenleyin. Raycast’in beklediği kesin şema sürüme göre değişebilir, ancak topluluk şablonları ve Raycast el kitabı yaygın yapıyı gösterir: id, name, base_url ve isteğe bağlı bir models bloğuna sahip sağlayıcı girdilerinin listesi. Aşağıda, CometAPI’yi OpenAI-ile uyumlu bir sağlayıcı olarak CometAPI’yi kaydetmek için güvenli ve çalışan bir örnek bulunuyor
Önemli notlar
YOUR_COMETAPI_KEYdeğerini güvenli bir başvuruyla değiştirin — kişisel kullanım için belirteci yapıştırabilirsiniz, ancak tercihen: macOS Anahtar Zinciri / Raycast’in desteklediği güvenli alanları kullanın.- Önemli satır
base_url’dür:https://api.cometapi.com/v1. adresini işaret edin. Raycast, OpenAI ile uyumlu çağrılar için bu temel URL’yi kullanacaktır. - Tüm modelleri önceden listelemeniz şart değildir — sağlayıcınız düzgün uygulanmış OpenAI tarzı
GET /v1/modelsuç noktası sunuyorsa Raycast model listelerini buradan çekebilir. CometAPI bir model listesi sunuyorsa, Raycast mevcut modelleri yenileyip görüntüleyebilir.
Adım 4: Modelleri yenileyin ve test edin
- Raycast’e geri dönün, yeni sağlayıcıdan modelleri çekip model seçiciyi doldurması için uygulamayı yeniden başlatmanız veya (sürüme bağlı olarak) “Refresh Models” komutunu kullanmanız gerekebilir. Modeller görünmüyorsa yenilemeyi veya yeniden başlatmayı öneririm.
- Basit bir Quick AI istemiyle model seçicide CometAPI’nin modelini seçin ve bir test istemi çalıştırın.
Raycast içinde CometAPI kullanırken en iyi uygulamalar
Güvenlik en iyi uygulamaları: Paylaşılan providers.yaml içinde belirteçleri asla hard-code etmeyin. Tercihen Raycast’in güvenli alanlarını veya macOS Anahtar Zinciri’ni kullanın ya da yerel bir proxy kullanıyorsanız ortam değişkenleriyle anahtarları yerelde enjekte edin. Hassas verileriniz varsa CometAPI ve Raycast’in gizlilik belgelerini okuyun.
Güvenilirlik ve performans: Kullanmayı düşündüğünüz modeller için gecikmeyi test edin — ağ geçidi API’lerinde yönlendirme değişken olabilir. Etkileşimli iş akışları (otomatik özetler, hızlı sorgular) için daha küçük, hızlı modelleri tercih edin. Daha derin akıl yürütme görevleri için daha geniş bağlamlı modelleri seçin.
Maliyet kontrolü: Model seçimini etkin biçimde kullanın: kısa görevler için hafif modelleri, yoğun akıl yürütme için yüksek kapasiteli modelleri seçin. Kullanımı CometAPI panelinden izleyin ve bütçe uyarıları ayarlayın. Belirteç kullanımını azaltmak için programatik istemleri düşünün (örn. daha kısa sistem mesajları, verimli bağlam yönetimi).
İstem tasarımı ve UX: Raycast AI Commands oluştururken (yerleşik bir komutu çoğaltıp istemi ayarlayın), yardımcı komutlar için istemleri deterministik tutun, fikir üretme iş akışları için ise daha açık bırakın. Yerleşik komutları kopyalamak ve istemleri özelleştirmek önerilen yoldur.
Yaygın sorunlar nasıl giderilir?
Modeller Raycast’te görünmüyor: providers.yaml dosyasının tam olarak Reveal Providers Config ile açılan klasörde olduğundan emin olun. Şablonu temel alın ve Raycast’i yeniden başlatın. Yeniden başlatma veya “Refresh Models” yardımcı olur.
401 / geçersiz belirteç: CometAPI belirtecinizin geçerli ve süresi dolmamış olduğunu doğrulayın. Yukarıdaki curl testini deneyin. Bearer belirteci kullandığınızı ve Authorization başlığının doğru olduğunu tekrar kontrol edin.
Model hataları veya uyumsuz yanıt biçimleri: CometAPI, OpenAI ile uyumlu olmayı amaçlar ancak bazı uç durumlar olabilir (model kimlikleri, akış davranışları). Raycast belirli bir akış biçimi bekliyor, CometAPI ise biraz farklı bir biçim döndürüyorsa önce akışsız bir çağrı deneyin ve gerekirse CometAPI desteğiyle iletişime geçin.
Sonuç
CometAPI, pek çok modele (metin, görsel, ses, video) birleşik, çok sağlayıcılı erişim sunar ve ekiplerin faturalama ile yönlendirmeyi merkezileştirmesine olanak tanır. Raycast, bu modelleri masaüstü iş akışlarınız bağlamında çağırmanız için anında, klavyeyle kontrollü bir alan sağlar. Birlikte, model denemelerini ve masaüstü otomasyonunu sürtünmesiz hale getirir — maliyet veya kalite için modelleri değiştirebilir, anahtarlarınızı yerelde tutabilir ve halihazırda betikleriniz ile uygulamalarınızda kullandığınız aynı OpenAI tarzı kalıpları kullanabilirsiniz.
Hemen denemek istiyorsanız, Playground’da CometAPI modellerin (Gemini 3 Pro Preview API vb.) yeteneklerini keşfedin ve ayrıntılı talimatlar için API kılavuzuna bakın. Erişmeden önce, lütfen CometAPI’ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. CometAPI, entegrasyona yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat sunar.
Hazır mısınız?→ CometAPI’yi Raycast’te bugün kullanın !
Daha fazla ipucu, rehber ve haber için bizi VK, X ve Discord üzerinden takip edin!
