Taruh model katalog di Raycast AI dengan satu providers.yaml.

Jawaban singkat: aktifkan Custom Providers, edit satu file.

Jalur Raycast untuk endpoint OpenAI-compatible adalah fitur Custom Providers, ditujukan untuk pengguna lanjutan dan nonaktif secara default. Aktifkan di bagian bawah section AI di Raycast Settings, pakai Reveal Providers Config untuk membuka folder config, dan salin providers.template.yaml yang dirilis ke providers.yaml. File-nya berada di ~/.config/raycast/ai/providers.yaml. Setiap entri provider menerima id, display name, base_url, dan block api_keys; setiap model yang Anda inginkan di picker dideklarasikan secara eksplisit dengan id-nya, display name, dan context window-nya, plus block abilities yang mendeskripsikan apa yang boleh diminta Raycast darinya. Bentuk base_url-nya mengikuti konvensi yang sama seperti contoh local-model bawaan, yang menunjuk ke root /v1, jadi nilai APIsRouter adalah https://api.apisrouter.com/v1. File ini menyimpan kredensial, jadi perlakukan seperti file secret mana pun.

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

Dua fitur Raycast yang terdengar mirip, dan tidak sama.

Raycast mendokumentasikan dua cara membawa akses AI Anda sendiri, dan mencari yang satu secara konsisten memunculkan yang lain, jadi perbedaannya layak dinyatakan dengan jelas. Bring Your Own Keys, halaman BYOK di manual Raycast, menghubungkan key pribadi Anthropic, Google, atau OpenAI Anda (OpenRouter di iOS) ke Raycast AI. Ini fitur yang lebih sederhana, terdokumentasi bisa berfungsi tanpa subscription Pro, tapi ini bukan endpoint custom: request merutekan lewat server Raycast untuk unifikasi API, dan manualnya eksplisit bahwa hanya model yang sudah tersedia di Raycast AI yang bisa diakses. Key gateway tidak bisa dipasang di sana, karena BYOK tidak pernah meminta URL. Custom Providers adalah fitur yang dikonfigurasi halaman ini: base_url Anda sendiri, key Anda sendiri, model yang Anda deklarasikan sendiri, request pergi ke mana pun Anda arahkan. Ini adalah jalur untuk gateway multi-vendor, untuk server lokal, dan untuk model apa pun yang tidak dibawa daftar bawaan Raycast. Trade-off-nya adalah eksplisitas, Raycast tidak mengambil daftar model endpoint untuk Anda (kenyamanan itu adalah feature request yang masih berdiri), jadi picker menunjukkan persis apa yang dideklarasikan YAML Anda, tidak lebih tidak kurang.

Mendeklarasikan model secara jujur: id, context, abilities.

Karena tidak ada autodiscovery, YAML-nya adalah kontrak, dan setiap field di dalamnya melakukan kerja nyata. Id model harus cocok persis dengan listing /v1/models gateway; itulah yang berjalan di request. Name hanyalah label yang ditampilkan Raycast. Nilai context memberi tahu Raycast berapa banyak riwayat percakapan yang boleh dikemas ke dalam request, jadi meremehkannya membuang kapabilitas dan melebih-lebihkannya menghasilkan request yang ditolak model; pakai window yang terdokumentasi untuk id yang Anda deklarasikan. Block abilities adalah yang paling sering disalahsangka orang. Ia mendeklarasikan apa yang boleh diandalkan Raycast: kontrol temperature, input vision, system message, tool use, reasoning effort. Mendeklarasikan ability yang tidak dimiliki model menghasilkan kegagalan runtime yang membingungkan di dalam fitur Raycast alih-alih error yang bersih, dan menghilangkan satu yang dimiliki model diam-diam menonaktifkan perilaku Raycast yang sesuai. Mulai minimal, temperature plus tools untuk model yang akan Anda pakai dengan AI extension, dan tambahkan ability seiring Anda mengonfirmasinya terhadap dokumentasi model. Ada extension Raycast yang dipelihara komunitas khusus untuk mengelola file ini dari UI, dengan backup otomatis sebelum setiap perubahan, layak diketahui jika YAML-manual bukan preferensi Anda. Bagaimanapun, Raycast membaca file dari disk, jadi setelah mengedit, beri pengaturan AI sejenak atau toggle fitur untuk memastikan picker-nya mencerminkan file saat ini.

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

Memilih model untuk launcher.

Karena setiap model yang dideklarasikan menagih lewat key yang sama, loop perbandingannya adalah beralih picker: jalankan quick command yang sama di dua id selama sehari, lalu baca pengeluaran per-model di konsol dan pertahankan yang layak mendapat tempatnya.

• AI launcher adalah kerja burst: ringkas ini, tulis ulang itu, jelaskan seleksi ini. claude-haiku-4-5-20251001 dan gemini-3.5-flash kembali sebelum animasi window selesai, yang merupakan rasa yang diharapkan pengguna Raycast.
• Sesi AI Chat dan penulisan draf panjang layak mendapat claude-sonnet-4-6 atau gpt-5.5; deklarasikan di samping tier cepat dan beralih per task di picker.
• AI extension yang memanggil tool butuh model dengan tool use yang bisa diandalkan, dan block abilities yang dideklarasikan sesuai; claude-sonnet-4-6 adalah pilihan pertama yang aman di sana.
• deepseek-v4-flash adalah pilihan volume untuk pengguna yang menyambungkan AI ke setiap text field yang mereka sentuh; completion kecil yang konstan menumpuk, dan tier cepat menjaga kebiasaan itu tak terlihat di saldo.
• Deklarasikan sedikit model secara sengaja alih-alih banyak secara spekulatif: setiap entri adalah baris picker yang Anda scroll lewati, dan YAML-nya mudah diperluas pada hari Anda membutuhkan id lain.

Bayar sesuai pemakaian · di bawah harga resmi

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

Mode kegagalan spesifik Raycast.

Mengonfigurasi BYOK padahal maksud Anda Custom Providers adalah kesalahan tingkat-atas, dan itu bukan salah Anda: kedua fitur berbagi ruang pencarian. Jika flow yang Anda ikuti meminta key vendor tapi tidak pernah URL, Anda ada di BYOK, dan gateway tidak cocok di sana. Mundur ke Settings, AI, dan toggle Custom Providers di bagian bawah. File yang terlihat diabaikan biasanya berarti toggle fitur mati, file masih bernama providers.template.yaml, atau YAML-nya punya error sintaks, dalam hal ini Raycast tidak punya apa pun yang valid untuk dimuat dan picker-nya cukup menunjukkan tidak ada model custom. Validasi YAML-nya sebelum mencurigai sesuatu yang lebih dalam. Model yang error pada beberapa fitur Raycast tapi tidak pada yang lain adalah ketidakcocokan abilities: AI extension yang memakai tool gagal sementara chat biasa berfungsi saat tools dideklarasikan pada model yang tidak memilikinya, atau tidak pernah dideklarasikan pada yang memilikinya. Request yang ditolak karena ukuran menunjuk ke nilai context yang dibesar-besarkan. Dan perhatikan batas platform secara jujur: Custom Providers dikonfigurasi di Mac, di file config lokal. Jika sebagian pemakaian Raycast Anda ada di tempat lain, periksa manual untuk apa yang didukung fitur ini di sana sebelum berasumsi setara.

Siapa yang merutekan Raycast AI melalui gateway.

• Power user yang hidup di launcher dan menginginkan quick AI command pada id katalog cepat tanpa subscription yang menentukan model mana yang boleh mereka sentuh.
• Orang yang sudah merutekan editor dan terminal tool mereka lewat gateway dan menginginkan launcher-nya di key yang sama, satu log penggunaan di semua permukaan.
• Pengguna yang menginginkan model yang tidak dibawa daftar bawaan Raycast, termasuk id DeepSeek dan GLM, dideklarasikan sekali di YAML dan tersedia di mana-mana di app.
• Builder AI-extension yang butuh model berkemampuan-tool tertentu di balik extension mereka, dipatok berdasarkan id alih-alih tunduk pada daftar hosted.
• Developer tanpa akses ke billing vendor tertentu. Akses berbasis top-up tanpa syarat kartu menghilangkan ketergantungan sign-up per provider.

Verifikasi endpoint dan debug command pertama.

Jalankan curl model dulu dan salin id dari outputnya ke YAML; mengetik id dari ingatan adalah penyebab utama error model-not-found di sini, karena file itu adalah satu-satunya sumber model yang dimiliki Raycast. Lalu aktifkan toggle-nya, konfirmasi picker menunjukkan nama yang Anda deklarasikan, dan jalankan satu quick AI command pada model cepat. Picker kosong berarti toggle-nya, nama file-nya, atau sintaks YAML-nya. Error autentikasi adalah block api_keys. Error not-found adalah ketidakcocokan id terhadap listing yang baru saja Anda curl. Command yang berfungsi di chat tapi gagal di AI extension adalah deklarasi abilities pada model itu. Setelah command mengalir, konsol APIsRouter menunjukkan model per request, hitungan token, dan pengeluaran. AI launcher adalah ratusan request kecil alih-alih beberapa yang besar, dan log penggunaan adalah tempat pola itu berubah jadi angka, per model, per hari, di halaman yang sama seperti setiap tool lain yang Anda rutekan lewat gateway.

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"}]}'

Pertanyaan umum