Cara menggunakan CometAPI di Raycast — panduan praktis

Fitur AI Raycast kini memungkinkan Anda menyambungkan penyedia apa pun yang kompatibel dengan OpenAI melalui penyedia kustom providers.yaml. CometAPI adalah API gateway yang mengekspose ratusan model melalui antarmuka 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, perintah, ekstensi).

Apa itu Raycast?

Raycast adalah peluncur produktivitas untuk macOS yang mengintegrasikan perintah, skrip, dan — semakin banyak — AI langsung ke sistem operasi Anda. Subsistem AI-nya menyediakan chat, perintah AI, pemilihan model, ekstensi (perangkat yang memungkinkan LLM menjalankan tindakan), serta kemampuan menggunakan model lokal (via Ollama) atau Bring Your Own Key / Custom Providers untuk terhubung ke penyedia model jarak jauh. Raycast menampilkan pemilih model, pengaturan untuk AI, dan templat providers.yaml yang dapat dikustomisasi pengguna mahir 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 milik mereka sendiri (memungkinkan pengelolaan biaya yang lebih fleksibel dan opsi penyedia privat). Perubahan ini menjadi fondasi teknis yang membuat integrasi CometAPI dapat dilakukan dari preferensi Raycast pengguna akhir.

Bagaimana Raycast menghadirkan AI ke pengguna?

• Quick AI: prompt instan dari peluncur.
• AI Chat: sesi percakapan dengan lampiran/konteks.
• AI Commands/Ekstensi: 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 mengekspose ratusan model AI berbeda (teks, gambar, audio, video, embedding) melalui satu permukaan REST bergaya OpenAI. Alih-alih menulis dan memelihara kode klien spesifik penyedia untuk OpenAI, Anthropic, Google, Midjourney, Runway, dll., Anda memanggil endpoint CometAPI dan memilih model yang diinginkan melalui string model. Penyederhanaan itu sangat berguna untuk eksperimen, perutean biaya/failover, serta sentralisasi penagihan dan observabilitas.

Kemampuan utama

• Penyelesaian teks/chat dan asisten (API chat ala OpenAI).
• Pembuatan gambar dan endpoint pengeditan gambar.
• Embedding 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 cuplikan SDK dan format permintaan bergaya OpenAI sehingga porting kode yang ada menjadi mudah.

Mengapa itu signifikan saat ini: pasar bergeser ke API gateway (endpoint tunggal yang praktis, 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 langsung 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/cepat atau yang khusus untuk tugas berbeda (ringkasan, kode, embedding, pembuatan gambar) sambil tetap di dalam Raycast.
• Penagihan dan throttling tersentralisasi melalui CometAPI sambil mengendalikan pemilihan model dari Raycast.
• Perubahan kode minimal: Raycast mendukung penyedia kustom yang kompatibel dengan OpenAI dan BYOK, jadi CometAPI sering kali cukup dipasang dengan mengganti base_url dan kunci API.

(Kemampuan ini dimungkinkan karena Raycast mendukung penyedia kustom dan BYOK, dan CometAPI mengekspose endpoint yang kompatibel dengan OpenAI di https://api.cometapi.com/v1. )

Apa saja use case yang bagus untuk integrasi ini?

1. Asisten pengembang: penjelasan kode, saran refaktor, pembuatan unit test, dan ringkasan PR — panggil dari Raycast dan dapatkan jawaban inline.
2. Catatan dan ringkasan: pilih teks, jalankan perintah Raycast untuk meringkas atau mengekstrak item tindakan menggunakan model ringkasan CometAPI.
3. Penulisan dokumentasi: buat dokumentasi fungsi atau cuplikan README melalui perintah Raycast AI dan pertahankan iterasi secara lokal.
4. Pembuatan gambar/multimedia: jika CometAPI mengekspose endpoint gambar, Anda dapat menggunakan ekstensi Raycast yang memanggil endpoint gambar (mis., ekstensi "Generate Image from Prompt") — berguna untuk mockup cepat.
5. Embedding + pencarian semantik: gunakan embedding CometAPI untuk mendukung alur kerja pencarian lokal — Raycast bisa 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 menyiapkan hal-hal berikut:

Sistem & Raycast

• macOS (Raycast bersifat native untuk 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, perbarui.

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 melalui 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.com dapat dijangkau.

Berkas lokal & lokasi

Konfigurasi penyedia AI Raycast berada di providers.yaml dalam direktori konfigurasi Raycast (aplikasi dapat menampilkan templat penyedia yang bisa Anda salin). Anda akan mengedit atau membuat providers.yaml untuk mendefinisikan penyedia kustom.

Bagaimana cara mengintegrasikan Raycast dengan CometAPI?

Gagasan inti: 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

1. Daftar di CometAPI dan buka konsol/dasbor.
2. 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

1. Di Raycast: Preferences → AI.
2. 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 nama menjadi providers.yaml.

Langkah 3: Tambahkan penyedia CometAPI ke providers.yaml

Buat atau edit berkas providers.yaml. Skema persis yang diharapkan Raycast dapat bervariasi menurut versi, namun templat komunitas dan panduan Raycast menunjukkan struktur umum: daftar entri penyedia dengan id, name, base_url dan blok models opsional. Di bawah ini adalah contoh yang aman dan berfungsi untuk mendaftarkan CometAPI sebagai OpenAI-co

Catatan penting

• Ganti YOUR_COMETAPI_KEY dengan referensi yang aman — tempelkan token (untuk penggunaan pribadi) atau yang lebih baik: simpan di macOS Keychain / kolom aman Raycast jika didukung.
• base_url adalah baris penting: arahkan ke https://api.cometapi.com/v1. Raycast akan menggunakan base URL itu untuk panggilan yang kompatibel dengan OpenAI.
• Anda tidak harus mencantumkan semua model di awal — Raycast dapat mengambil daftar model dari endpoint GET /v1/models bergaya OpenAI jika penyedia Anda mengekspose-nya. Jika CometAPI mengekspose 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 menyarankan 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 terbaik keamanan: Jangan pernah meng-hardcode token di providers.yaml yang dibagikan. Lebih baik gunakan kolom aman Raycast atau macOS Keychain, atau injeksikan kunci secara lokal menggunakan variabel lingkungan jika Anda menggunakan proxy lokal. Baca dokumen privasi CometAPI dan Raycast jika Anda menangani data sensitif.

Keandalan & performa: Uji latensi untuk model yang ingin Anda gunakan — API gateway dapat memiliki perutean yang bervariasi. Untuk alur kerja interaktif (ringkasan otomatis, pencarian cepat) pilih model yang lebih kecil dan cepat. Untuk tugas penalaran yang lebih dalam pilih model ber-konteks lebih tinggi.

Kontrol biaya: Gunakan pemilihan model secara agresif: pilih model ringan untuk tugas singkat, model berkapasitas tinggi untuk penalaran berat. Lacak penggunaan di dasbor CometAPI dan atur peringatan anggaran. Pertimbangkan prompt terprogram untuk mengurangi penggunaan token (mis., pesan sistem yang lebih pendek, manajemen konteks efisien).

Prompt engineering & UX: Saat membuat Raycast AI Commands (duplikasi perintah bawaan dan sesuaikan prompt), buat prompt deterministik untuk perintah utilitas (ringkasan, triase, pencarian) dan lebih terbuka untuk alur kerja ideasi. Menyalin perintah bawaan dan menyesuaikan prompt adalah cara yang direkomendasikan.

Bagaimana 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. Memulai ulang atau “Refresh Models” membantu.

401 / token tidak valid: Pastikan token CometAPI Anda valid dan tidak kedaluwarsa. Coba uji curl di atas. Pastikan Anda menggunakan token Bearer dan header Authorization benar.

Kesalahan model atau bentuk respons tidak kompatibel: CometAPI bertujuan kompatibel dengan OpenAI tetapi beberapa kasus tepi mungkin ada (ID model, perilaku streaming). Jika Raycast mengharapkan format streaming tertentu dan CometAPI mengeluarkan bentuk yang sedikit berbeda, coba panggilan non-streaming terlebih dahulu dan hubungi dukungan CometAPI jika perlu.

Kesimpulan

CometAPI memberi Anda akses multi-vendor yang terpadu ke banyak model (teks, gambar, audio, video) dan memungkinkan tim melakukan sentralisasi penagihan dan perutean. Raycast memberi Anda tempat yang instan dan berfokus pada keyboard untuk memanggil model tersebut dalam konteks alur kerja desktop Anda. Bersama-sama keduanya membuat eksperimen model dan automasi desktop menjadi tanpa hambatan — Anda dapat menukar model demi biaya atau kualitas, menyimpan kunci secara lokal, dan menggunakan pola bergaya OpenAI yang sama seperti yang sudah Anda miliki di skrip dan aplikasi.

Jika ingin mencoba sekarang, jelajahi kemampuan model (Gemini 3 Pro Preview API dll) dari CometAPI di Playground dan lihat 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 melakukan integrasi.

Siap mulai?→ gunakan CometAPI di Raycast hari ini !

Jika Anda ingin mengetahui lebih banyak kiat, panduan, dan berita tentang AI, ikuti kami di VK, X dan Discord!