Fitur AI Raycast kini memungkinkan Anda menyambungkan penyedia apa pun yang kompatibel dengan OpenAI melalui penyedia kustom providers.yaml. CometAPI adalah gateway API yang mengekspos ratusan model di balik permukaan REST bergaya OpenAI — sehingga Anda dapat mengarahkan Raycast ke https://api.cometapi.com/v1, menambahkan kunci CometAPI Anda, dan menggunakan model CometAPI di dalam Raycast AI (chat, commands, extensions).
Apa itu Raycast?
Raycast adalah peluncur produktivitas untuk macOS yang mengintegrasikan perintah, skrip, dan — kian sering — AI langsung ke sistem operasi Anda. Subsistem AI-nya menyediakan chat, perintah AI, pemilihan model, ekstensi (perangkat yang memungkinkan LLM melakukan aksi), serta kemampuan menggunakan model lokal (via Ollama) atau Bring Your Own Key / Custom Providers untuk menyambungkan penyedia model jarak jauh. Raycast menyediakan pemilih model, pengaturan untuk AI, dan templat providers.yaml yang dapat disesuaikan pengguna tingkat lanjut untuk menambahkan backend yang kompatibel dengan OpenAI.
Raycast telah meluncurkan BYOK (Bring Your Own Key) dan Custom Providers pada 2025, memungkinkan pengguna menjalankan Raycast AI menggunakan kunci API dan endpoint kustom mereka sendiri (memungkinkan pengelolaan biaya yang lebih fleksibel dan opsi penyedia privat). Perubahan ini adalah fondasi teknis yang membuat integrasi CometAPI layak dari preferensi Raycast di sisi pengguna akhir.
Bagaimana Raycast menghadirkan AI kepada pengguna?
- Quick AI: prompt instan dari launcher.
- AI Chat: sesi percakapan dengan lampiran/konteks.
- AI Commands/Extensions: perintah atau alat buatan pengembang yang menggunakan LLM.
(Anda dapat mengelola model, kunci BYOK, dan penyedia kustom dari Settings → AI.)
Apa itu CometAPI?
CometAPI adalah platform agregasi API yang mengekspos ratusan model AI berbeda (teks, gambar, audio, video, embeddings) melalui satu permukaan REST bergaya OpenAI. Alih-alih menulis dan memelihara kode klien khusus penyedia untuk OpenAI, Anthropic, Google, Midjourney, Runway, dll., Anda memanggil endpoint CometAPI dan memilih model yang diinginkan melalui string model. Penyederhanaan itu sangat membantu untuk eksperimen, perutean biaya/failover, serta sentralisasi penagihan dan observabilitas.
Kemampuan utama
- Text/chat completions dan assistants (API chat seperti OpenAI).
- Pembuatan gambar dan endpoint pengeditan gambar.
- Embeddings untuk pencarian semantik/RAG (retrieval-augmented generation).
- Audio (TTS dan STT ketika disediakan oleh model yang mendasari).
- Pembuatan video untuk backend khusus (Sora, Veo, dll.).
CometAPI juga menyediakan snippet SDK dan format permintaan bergaya OpenAI sehingga porting kode yang ada menjadi sederhana.
Mengapa itu signifikan saat ini: pasar bergeser menuju gateway API (endpoint tunggal yang nyaman, opsi lebih murah, dan pilihan model). CometAPI adalah salah satu pemain komersial di ruang tersebut, sehingga menggabungkannya dengan dukungan penyedia kustom Raycast memberi Anda akses instan ke katalog model yang luas dari alur kerja macOS Anda.
Mengapa mengintegrasikan CometAPI dengan Raycast?
Jawaban singkat: untuk menjalankan model apa pun yang diekspos CometAPI langsung dari alur Raycast AI Anda — Quick AI, AI Chat, atau perintah AI kustom — tanpa mengganti alat.
Manfaat:
- Gunakan model yang lebih murah/lebih cepat atau khusus untuk tugas berbeda (ringkasan, kode, embeddings, pembuatan gambar) sambil tetap di dalam Raycast.
- Penagihan dan throttling terpusat melalui CometAPI dengan kontrol pemilihan model dari Raycast.
- Perubahan kode minimal: Raycast mendukung penyedia kustom yang kompatibel dengan OpenAI dan BYOK, jadi CometAPI sering kali terpasang hanya dengan menukar
base_urldan kunci API.
(Kemampuan ini dimungkinkan karena Raycast mendukung penyedia kustom dan BYOK, dan CometAPI mengekspos endpoint yang kompatibel dengan OpenAI di https://api.cometapi.com/v1. )
Kasus penggunaan apa yang cocok untuk integrasi ini?
- Developer helper: penjelasan kode, saran refactor, pembuatan unit test, dan peringkasan PR — panggil dari Raycast dan dapatkan jawaban inline.
- Catatan dan ringkasan: pilih teks, jalankan perintah Raycast untuk meringkas atau mengekstrak item tindakan menggunakan model peringkasan CometAPI.
- Penulisan dokumentasi: buat dokumentasi fungsi atau potongan README via perintah Raycast AI dan lakukan iterasi secara lokal.
- Pembuatan gambar/multimedia: jika CometAPI mengekspos endpoint gambar, Anda dapat menggunakan ekstensi Raycast yang memanggil endpoint gambar (misalnya ekstensi "Generate Image from Prompt") — berguna untuk mockup cepat.
- Embeddings + pencarian semantik: gunakan embeddings CometAPI untuk menggerakkan alur kerja pencarian lokal — Raycast dapat menjadi front-end yang melakukan query ke indeks embedding Anda melalui skrip lokal kecil atau fungsi cloud.
Lingkungan dan kondisi apa yang harus disiapkan?
Sebelum memulai, pastikan Anda telah menyiapkan hal-hal berikut:
Sistem & Raycast
- macOS (Raycast adalah aplikasi native macOS).
- Raycast terpasang. Disarankan versi terbaru yang mendukung Custom Providers / BYOK (Raycast menambahkan BYOK di v1.100.0 dan terus meluncurkan Custom Providers). Jika Raycast Anda lebih lama, lakukan pembaruan.
Akun & kunci
- Akun CometAPI dan kunci API CometAPI yang valid (Anda akan menggunakannya di pengaturan Raycast atau variabel lingkungan). Lihat dasbor/dokumentasi CometAPI.
Alat pengembang opsional (untuk pengujian atau pengembangan lokal)
- Terminal (untuk cURL).
- Python / Node / SDK OpenAI jika Anda ingin menguji akses CometAPI secara langsung sebelum menghubungkannya ke Raycast. CometAPI mendukung penggunaan langsung via SDK standar dengan menimpa
base_url.
Izin & jaringan
- Pastikan Raycast dan kebijakan jaringan macOS Anda mengizinkan panggilan HTTPS ke
api.cometapi.com. - Jika Anda berada di lingkungan perusahaan dengan proxy/firewall, verifikasi
api.cometapi.comdapat dijangkau.
Berkas lokal & lokasi
Konfigurasi providers AI Raycast berada di providers.yaml dalam direktori konfigurasi Raycast (aplikasi dapat menampilkan templat providers yang bisa Anda salin). Anda akan mengedit atau membuat providers.yaml untuk mendefinisikan penyedia kustom.
Bagaimana cara mengintegrasikan Raycast dengan CometAPI?
Gagasan utamanya: daftarkan CometAPI sebagai penyedia kustom yang kompatibel dengan OpenAI di Raycast, arahkan Raycast ke https://api.cometapi.com/v1, dan tambahkan token Comet Anda ke kunci API kustom Raycast.
Langkah 1: Dapatkan kunci CometAPI Anda
- Daftar di CometAPI dan buka konsol/dasbor.
- Buat token API. Salin token ini ke tempat yang aman (atau simpan untuk langkah berikutnya).
Langkah 2: Buka pengaturan AI Raycast dan aktifkan penyedia kustom
- Di Raycast:
Preferences→AI. - Temukan “Custom Providers” (atau “Custom OpenAI-compatible APIs”) dan klik Reveal Providers Config. Raycast akan membuka Finder di direktori konfigurasi dan menyediakan berkas templat (biasanya
providers.template.yaml) untuk disalin dan diubah namanya menjadiproviders.yaml.
Langkah 3: Tambahkan penyedia CometAPI ke providers.yaml
Buat atau edit berkas providers.yaml. Skema persis yang diharapkan Raycast dapat bervariasi menurut versi, tetapi templat komunitas dan manual Raycast menampilkan struktur umum: daftar entri penyedia dengan id, name, base_url dan blok models opsional. Berikut adalah contoh yang aman dan berfungsi untuk mendaftarkan CometAPI sebagai OpenAI-co
Catatan penting
- Ganti
YOUR_COMETAPI_KEYdengan referensi yang aman — bisa ditempel untuk penggunaan pribadi atau, yang lebih baik: simpan di Keychain macOS / field aman Raycast jika didukung. base_urladalah baris penting: arahkan kehttps://api.cometapi.com/v1. Raycast akan menggunakan base URL tersebut untuk panggilan yang kompatibel dengan OpenAI.- Anda tidak wajib mencantumkan semua model terlebih dahulu — Raycast dapat mengambil daftar model dari endpoint OpenAI-style
GET /v1/modelsjika penyedia Anda mengeksposnya. Jika CometAPI mengekspos daftar model, Raycast dapat menyegarkan dan menampilkan model yang tersedia.
Langkah 4: Segarkan model dan uji
- Kembali di Raycast, Anda mungkin perlu memulai ulang aplikasi atau menggunakan perintah “Refresh Models” (tergantung versi) agar Raycast mengambil model dari penyedia baru dan mengisi pemilih model. Saya sarankan menyegarkan atau memulai ulang jika model tidak muncul.
- Gunakan prompt Quick AI sederhana untuk memilih model CometAPI dari pemilih model dan jalankan prompt uji.
Praktik terbaik saat menggunakan CometAPI di dalam Raycast
Praktik keamanan: Jangan pernah menanamkan token di providers.yaml yang dibagikan. Lebih baik gunakan field aman Raycast atau Keychain macOS, atau injeksikan kunci secara lokal menggunakan variabel lingkungan jika Anda memakai proxy lokal. Baca dokumen privasi CometAPI dan Raycast jika Anda menangani data sensitif.
Keandalan & kinerja: Uji latensi untuk model yang ingin Anda gunakan — gateway API dapat memiliki rute yang bervariasi. Untuk alur kerja interaktif (autosummary, lookup cepat) pilih model yang lebih kecil dan cepat. Untuk tugas penalaran mendalam pilih model ber-konteks lebih tinggi.
Kontrol biaya: Gunakan pemilihan model secara agresif: pilih model ringan untuk tugas pendek, model berkapasitas tinggi untuk penalaran berat. Lacak penggunaan di dasbor CometAPI dan atur peringatan anggaran. Pertimbangkan prompt yang lebih terprogram untuk mengurangi penggunaan token (misalnya, pesan sistem lebih pendek, manajemen konteks efisien).
Prompt engineering & UX: Saat membuat Raycast AI Commands (duplikasi perintah bawaan dan sesuaikan prompt), jaga prompt deterministik untuk perintah utilitas (ringkasan, triase, pencarian) dan lebih terbuka untuk alur ideasi. Menyalin perintah bawaan dan menyesuaikan prompt adalah cara yang direkomendasikan.
Bagaimana cara memecahkan masalah umum?
Model tidak muncul di Raycast: Pastikan providers.yaml Raycast berada persis di folder yang ditampilkan oleh Reveal Providers Config. Gunakan templat sebagai baseline dan mulai ulang Raycast. Restart atau “Refresh Models” membantu.
401 / invalid token: Pastikan token CometAPI Anda valid dan tidak kedaluwarsa. Coba uji curl di atas. Periksa kembali bahwa Anda menggunakan Bearer token dan header Authorization sudah benar.
Error model atau bentuk respons tidak kompatibel: CometAPI bertujuan kompatibel dengan OpenAI tetapi ada beberapa edge case (ID model, perilaku streaming). Jika Raycast mengharapkan format streaming tertentu dan CometAPI mengeluarkan bentuk yang sedikit berbeda, coba panggilan non-streaming terlebih dulu dan hubungi dukungan CometAPI jika perlu.
Kesimpulan
CometAPI memberi Anda akses terpadu, multi-vendor ke banyak model (teks, gambar, audio, video) dan memungkinkan tim memusatkan penagihan serta perutean. Raycast memberi Anda tempat yang instan dan berfokus pada keyboard untuk memanggil model-model tersebut dalam konteks alur kerja desktop Anda. Bersama-sama, keduanya membuat eksperimen model dan otomasi desktop tanpa hambatan — Anda dapat mengganti model demi biaya atau kualitas, menyimpan kunci Anda secara lokal, dan menggunakan pola bergaya OpenAI yang sudah familier di skrip serta aplikasi Anda.
Jika Anda ingin langsung mencoba, jelajahi kapabilitas model (Gemini 3 Pro Preview API dll) dari CometAPI di Playground dan baca panduan API untuk instruksi terperinci. Sebelum mengakses, pastikan Anda telah masuk ke CometAPI dan memperoleh kunci API. CometAPI menawarkan harga yang jauh lebih rendah daripada harga resmi untuk membantu Anda berintegrasi.
Siap jalan?→ gunakan CometAPI di Raycast hari ini !
Jika Anda ingin mengetahui lebih banyak tips, panduan, dan berita seputar AI, ikuti kami di VK, X, dan Discord!