Raycast'te CometAPI nasıl kullanılır — pratik bir rehber

Raycast’in AI özellikleri artık providers.yaml özel sağlayıcısı aracılığıyla herhangi bir OpenAI uyumlu sağlayıcıyı takmanıza izin veriyor. CometAPI, yüzlerce modeli OpenAI tarzı bir REST yüzeyinin arkasında sunan bir geçit (gateway) API’sidir — bu nedenle Raycast’i https://api.cometapi.com/v1 adresine yönlendirebilir, CometAPI anahtarınızı ekleyebilir ve CometAPI modellerini Raycast AI içinde (sohbet, komutlar, uzantılar) kullanabilirsiniz.

Raycast nedir?

Raycast, komutları, komut dosyalarını ve — giderek artan ölçüde — AI’ı doğrudan işletim sisteminize entegre eden macOS için bir üretkenlik başlatıcısıdır. AI alt sistemi sohbet, AI 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 Bring Your Own Key / Custom Providers kullanma yeteneği sağlar. Raycast, bir model seçici, AI için ayarlar ve gelişmiş kullanıcıların OpenAI uyumlu arka uçlar eklemek üzere özelleştirebileceği bir providers.yaml şablonu sunar.

Raycast, 2025’te BYOK (Bring Your Own Key) ve Custom Providers’ı yayına alıyor; bu da kullanıcıların Raycast AI’ı kendi API anahtarları ve özel uç noktalarıyla çalıştırmasını sağlıyor (daha esnek maliyet yönetimi ve özel sağlayıcı seçeneklerini mümkün kılıyor). Bu değişiklik, son kullanıcı Raycast tercihleri üzerinden CometAPI entegrasyonunu mümkün kılan teknik temeldir.

Raycast, AI’ı kullanıcılara nasıl sunar?

• Quick AI: başlatıcıdan anında istemler.
• AI Chat: ekler/bağlam içeren konuşmalı oturumlar.
• AI Commands/Extensions: LLM’leri eylem yürütmek için kullanan geliştirici yapımı komutlar veya araçlar.
  (Modelleri, BYOK anahtarlarını ve özel sağlayıcıları Settings → AI üzerinden yönetebilirsiniz.)

CometAPI nedir?

CometAPI, yüzlerce farklı AI modelini (metin, görsel, ses, video, embedding) tek bir OpenAI tarzı REST yüzeyi üzerinden sunan bir API-toplama platformudur. OpenAI, Anthropic, Google, Midjourney, Runway vb. için sağlayıcıya özel istemci kodu yazıp sürdürmek yerine CometAPI uç noktasını çağırırsınız ve istediğiniz modeli bir model dizesiyle seçersiniz. Bu basitleştirme; deney, maliyet/yedek yönlendirme ve faturalandırma ile gözlemlenebilirliği merkezileştirmek 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 için embedding’ler.
• Ses (temel modeller sağladığında TTS ve STT).
• Uzmanlaşmış arka uçlar için video üretimi (Sora, Veo, vb.).
  CometAPI ayrıca SDK parçacıkları ve OpenAI tarzı istek formatları sunar; böylece mevcut kodu taşımak kolaydır.

Şu anda neden önemli: pazar, geçit (gateway) API’lerine yöneliyor (kullanışlı tek uç nokta, daha ucuz seçenekler ve model seçimi). CometAPI bu alandaki ticari oyunculardan biri olduğundan, Raycast’in özel sağlayıcı desteğiyle birleştiğinde 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 Raycast AI akışınızdan — Quick AI, AI Chat veya özel AI komutları — araç değiştirmenize gerek kalmadan çalıştırmak için.

Faydalar:

• Raycast içinde kalırken farklı görevler için daha ucuz/daha hızlı veya uzmanlaşmış modelleri (özetler, kod, embedding, görsel üretimi) kullanın.
• Model seçimini Raycast’ten kontrol ederken faturalandırma ve sınırlamayı CometAPI üzerinden merkezîleştirin.
• Asgari kod değişikliği: Raycast, OpenAI uyumlu özel sağlayıcıları ve BYOK’u destekler; bu nedenle CometAPI genellikle yalnızca base_url ve API anahtarını değiştirerek bağlanır.

(Bu yetenekler, Raycast’in özel sağlayıcıları ve BYOK’u desteklemesi ve CometAPI’nin OpenAI uyumlu uç noktaları https://api.cometapi.com/v1. adresinde sunması sayesinde mümkündür.)

Bu entegrasyon için iyi kullanım senaryoları nelerdir?

1. Geliştirici yardımcısı: kod açıklaması, yeniden düzenleme önerileri, birim test üretimi ve PR özetleme — Raycast’ten çağırın ve satır içi yanıtlar alın.
2. Notlar ve özetler: metin seçin, bir Raycast komutu çalıştırarak CometAPI özetleme modelini kullanın ve eylem öğelerini çıkarın.
3. Dokümantasyon yazımı: Raycast AI komutlarıyla fonksiyon dokümanları veya README parçacıkları üretin ve iterasyonları yerelde tutun.
4. Görsel / multimedya üretimi: CometAPI görsel uç noktaları sunuyorsa, görsel uç noktalarını çağıran Raycast uzantılarını (örn. “Generate Image from Prompt” uzantısı) kullanabilirsiniz — hızlı taslaklar için yararlı.
5. Embedding + anlamsal arama: CometAPI embedding’lerini yerel arama iş akışlarını güçlendirmek için kullanın — Raycast, embedding indeksinizi küçük bir yerel betik veya bir bulut fonksiyonu üzerinden sorgulayan ön uç olabilir.

Hangi ortam ve koşullar gerekli?

Başlamadan önce aşağıdakilerin hazır olduğundan emin olun:

Sistem ve Raycast

• macOS (Raycast macOS’a özgüdür).
• Raycast kurulu. Özel Sağlayıcılar / BYOK’u destekleyen güncel bir sürüm tercih edin (Raycast, BYOK’u v1.100.0 sürümünde ekledi ve Özel Sağlayıcıları yayına almaya 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 panosuna/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.com adresine HTTPS çağrılarına izin verdiğinden emin olun.
• Kurumsal bir ortamda proxy/güvenlik duvarı varsa, api.cometapi.com adresine erişilebilirliği 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ılar ş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 özel bir OpenAI uyumlu sağlayıcı olarak kaydedin, Raycast’i https://api.cometapi.com/v1 adresine yönlendirin ve Comet jetonunuzu Raycast’in özel API anahtarlarına ekleyin.

Adım 1: CometAPI anahtarınızı alın

1. CometAPI’ye kaydolun ve konsolu / panoyu açın.
2. Bir API jetonu oluşturun . Bu jetonu güvenli bir yere kopyalayın (veya bir 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

1. Raycast’te: Preferences → AI.
2. “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 kopyalayıp providers.yaml olarak yeniden adlandırabileceğiniz bir şablon dosyası (genellikle providers.template.yaml) sağlar.

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 ş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ğu bulunan sağlayıcı girdilerinin listesi. Aşağıda, CometAPI’yi OpenAI-co olarak kaydetmek için güvenli ve çalışan bir örnek yer alıyor

Önemli notlar

• YOUR_COMETAPI_KEY değerini güvenli bir başvuru ile değiştirin — kişisel kullanım için jetonu yapıştırabilir veya daha iyisi: destekleniyorsa macOS Keychain / Raycast’in güvenli alanlarını kullanın.
• base_url önemli satırdır: https://api.cometapi.com/v1. adresini işaret edin. Raycast, OpenAI uyumlu çağrılar için bu temel URL’yi kullanacaktır.
• Tüm modelleri önceden listelemeniz şart değil — sağlayıcınız uygun şekilde uygulanmış bir OpenAI tarzı GET /v1/models uç noktası sunuyorsa Raycast model listesini çekebilir. CometAPI bir model listesi sunuyorsa Raycast mevcut modelleri yenileyip gösterebilir.

Adım 4: Modelleri yenileyin ve test edin

• Raycast’e geri döndüğünüzde, Raycast’in 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) bir “Refresh Models” komutu kullanmanız gerekebilir. Modeller görünmüyorsa yenilemeyi veya yeniden başlatmayı öneririm.
• Basit bir Quick AI istemi kullanarak model seçiciden 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 dosyasında jetonları asla sabitlemeyin. Raycast’in güvenli alanlarını veya macOS Keychain’i tercih edin ya da yerel bir ara sunucu kullanıyorsanız anahtarları ortam değişkenleriyle yerelde enjekte edin. Hassas verileriniz varsa CometAPI ve Raycast gizlilik belgelerini okuyun.

Güvenilirlik ve performans: Kullanmayı planladığınız modeller için gecikmeyi test edin — geçit API’lerinde yönlendirme değişken olabilir. Etkileşimli iş akışları (oto-özetler, hızlı bakışlar) için daha küçük, daha hızlı modelleri; daha derin akıl yürütme görevleri için daha yüksek bağlam kapasiteli modelleri tercih edin.

Maliyet kontrolü: Model seçimini agresif 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. CometAPI panosunda kullanımı takip edin ve bütçe uyarıları ayarlayın. Jeton 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 Komutları oluştururken (yerleşik bir komutu kopyalayıp istemi ayarlayın), yardımcı komutlar için istemleri deterministik; fikir üretimi iş akışlarında ise daha açık uçlu tutun. Yerleşik komutları kopyalayıp 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çığa çıkarı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 / invalid token: CometAPI jetonunuzun geçerli ve süresi dolmamış olduğundan emin olun. Yukarıdaki curl testini deneyin. Bir Bearer jetonu kullandığınızı ve Authorization başlığının doğru olduğunu iki kez kontrol edin.

Model hataları veya uyumsuz yanıt şekilleri: CometAPI, OpenAI uyumlu olmayı hedefler ancak bazı köşe durumları bulunabilir (model kimlikleri, akış davranışları). Raycast belirli bir akış formatı bekleyip CometAPI biraz farklı bir şekil döndürüyorsa, önce akışsız bir çağrı deneyin ve gerekirse CometAPI desteğiyle iletişime geçin.

Sonuç

CometAPI, birçok modele (metin, görsel, ses, video) birleşik, çok sağlayıcılı erişim sunar ve ekiplerin faturalandırma ve yönlendirmeyi merkezileştirmesine olanak tanır. Raycast, bu modelleri masaüstü iş akışlarınız bağlamında çağırmak için anında, klavye odaklı bir yer sağlar. Birlikte, model denemelerini ve masaüstü otomasyonunu sürtünmesiz hâle getirirler — maliyet veya kalite için modelleri değiştirebilir, anahtarlarınızı yerel tutabilir ve betiklerde ve uygulamalarda zaten kullandığınız tanıdık OpenAI tarzı kalıpları devam ettirebilirsiniz.

Hemen denemek istiyorsanız, CometAPI Playground’da modellerin (Gemini 3 Pro Preview API vb.) yeteneklerini keşfedin ve ayrıntılı talimatlar için API kılavuzunu inceleyin. Erişimden önce, lütfen CometAPI’ye giriş yaptığınızdan ve API anahtarını aldığınızdan emin olun. CometAPI, entegrasyona yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat sunar.

Hazır mısınız?→ bugün Raycast’te CometAPI’yi kullanın !

Daha fazla ipucu, rehber ve AI haberleri için bizi VK, X ve Discord’da takip edin!