Letakkan model katalog dalam Raycast AI dengan satu providers.yaml.

Jawapan pantas: hidupkan Custom Providers, sunting satu fail.

Laluan Raycast untuk endpoint serasi OpenAI adalah ciri Custom Providers, disasarkan kepada pengguna lanjutan dan dimatikan secara lalai. Hidupkan di bahagian bawah bahagian AI dalam Tetapan Raycast, guna Reveal Providers Config untuk membuka folder config, dan salin providers.template.yaml yang dihantar kepada providers.yaml. Fail itu tinggal di ~/.config/raycast/ai/providers.yaml. Setiap entri penyedia mengambil id, nama paparan, base_url, dan blok api_keys; setiap model yang anda mahukan dalam pemilih diisytiharkan secara eksplisit dengan id, nama paparan, dan tetingkap konteksnya, ditambah blok abilities yang menerangkan apa yang Raycast boleh minta daripadanya. Bentuk base_url mengikut konvensyen yang sama seperti contoh model-setempat terbina dalam, yang menunjuk ke root /v1, jadi nilai APIsRouter adalah https://api.apisrouter.com/v1. Fail itu memegang kelayakan, jadi layankan seperti mana-mana fail rahsia.

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 ciri Raycast yang berbunyi serupa, dan tidak sama.

Raycast mendokumentasikan dua cara membawa akses AI sendiri, dan mencari satu secara boleh dipercayai muncul yang lain, jadi perbezaan itu berbaloi dinyatakan dengan jelas. Bring Your Own Keys, halaman BYOK dalam manual Raycast, menyambungkan kunci peribadi Anthropic, Google, atau OpenAI anda (OpenRouter pada iOS) kepada Raycast AI. Ia adalah ciri yang lebih mudah, didokumentasikan berfungsi tanpa langganan Pro, tetapi ia bukan endpoint custom: permintaan menghalakan melalui pelayan Raycast untuk penyatuan API, dan manual jelas bahawa hanya model yang sudah tersedia dalam Raycast AI boleh dicapai. Kunci gateway tidak boleh dipasang di situ, kerana BYOK tidak pernah meminta URL. Custom Providers adalah ciri yang dikonfigurasikan halaman ini: base_url anda sendiri, kunci anda sendiri, model yang anda isytiharkan sendiri, permintaan pergi ke mana sahaja yang anda arahkan. Ia adalah laluan untuk gateway multi-vendor, untuk pelayan setempat, dan untuk mana-mana model yang tidak dibawa senarai terbina-dalam Raycast. Pertukarannya adalah keeksplisitan; Raycast tidak mengambil senarai model endpoint untuk anda (kemudahan itu adalah permintaan ciri berterusan), jadi pemilih menunjukkan tepat apa yang diisytiharkan YAML anda, tidak lebih tidak kurang.

Mengisytiharkan model secara jujur: id, konteks, keupayaan.

Kerana tiada autodiscovery, YAML adalah kontrak, dan setiap medan di dalamnya melakukan kerja sebenar. Id model mesti sepadan tepat dengan senarai /v1/models gateway; itulah yang bergerak dalam permintaan. Nama hanya label yang ditunjukkan Raycast. Nilai context memberitahu Raycast berapa banyak sejarah perbualan yang boleh dibungkusnya ke dalam permintaan, jadi menyatakan kurang membazir keupayaan dan menyatakan lebih menghasilkan permintaan yang ditolak model; guna tetingkap yang didokumentasikan untuk id yang anda isytiharkan. Blok abilities adalah yang paling sering tersilap. Ia mengisytiharkan apa yang Raycast boleh bergantung: kawalan suhu, input penglihatan, mesej sistem, penggunaan alatan, usaha penaakulan. Mengisytiharkan keupayaan yang model tiada menghasilkan kegagalan runtime yang mengelirukan di dalam ciri Raycast berbanding ralat bersih, dan meninggalkan satu yang sebenarnya dimiliki model melumpuhkan tingkah laku Raycast yang sepadan secara senyap. Mula minimum, suhu ditambah alatan untuk model yang akan anda gunakan dengan sambungan AI, dan tambah keupayaan apabila anda mengesahkannya terhadap dokumentasi model. Sambungan Raycast yang diselenggara komuniti wujud khas untuk menguruskan fail ini daripada UI, dengan sandaran automatik sebelum setiap perubahan, berbaloi diketahui jika YAML-secara-tangan bukan pilihan anda. Apa jua caranya, Raycast membaca fail daripada cakera, jadi selepas menyunting, berikan tetapan AI seketika atau togol ciri itu untuk memastikan pemilih mencerminkan fail semasa.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# isytiharkan id ini verbatim dalam providers.yaml

Memilih model untuk launcher.

Kerana setiap model yang diisytiharkan berbil melalui kunci yang sama, gelung perbandingan adalah pertukaran pemilih: jalankan arahan pantas yang sama pada dua id selama sehari, kemudian baca perbelanjaan per-model dalam konsol dan kekalkan yang mewajarkan tempatnya.

• AI launcher adalah kerja berbentuk letusan: ringkaskan ini, tulis semula itu, jelaskan pilihan. claude-haiku-4-5-20251001 dan gemini-3.5-flash pulang sebelum animasi tetingkap selesai, iaitu rasa yang diharapkan pengguna Raycast.
• Sesi AI Chat dan merangka panjang mewajarkan claude-sonnet-4-6 atau gpt-5.5; isytiharkan bersebelahan tier pantas dan tukar per tugasan dalam pemilih.
• Sambungan AI yang memanggil alatan memerlukan model dengan penggunaan alatan yang boleh dipercayai, dan blok abilities diisytiharkan sepadan; claude-sonnet-4-6 adalah pilihan pertama yang selamat di situ.
• deepseek-v4-flash adalah pilihan volum untuk pengguna yang memasang AI ke dalam setiap medan teks yang mereka sentuh; completions kecil berterusan bertambah, dan tier pantas mengekalkan tabiat itu tidak kelihatan pada baki.
• Isytiharkan sedikit model secara sengaja berbanding banyak secara spekulatif: setiap entri adalah baris pemilih yang anda tatal lalui, dan YAML mudah dilanjutkan pada hari anda memerlukan id lain.

Bayar mengikut penggunaan · bawah harga rasmi

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

Mod kegagalan khusus Raycast.

Mengkonfigurasikan BYOK apabila anda memaksudkan Custom Providers adalah kesilapan peringkat-atas, dan bukan salah anda: kedua-dua ciri berkongsi ruang carian. Jika aliran yang anda gunakan meminta kunci vendor tetapi tidak pernah URL, anda berada dalam BYOK, dan gateway tidak tergolong di situ. Undur ke Settings, AI, dan togol Custom Providers di bahagian bawah. Fail diabaikan biasanya bermaksud togol ciri dimatikan, fail masih bernama providers.template.yaml, atau YAML mempunyai ralat sintaks, dalam hal ini Raycast tiada apa sah untuk dimuatkan dan pemilih hanya menunjukkan tiada model custom. Sahkan YAML sebelum mengesyaki apa-apa yang lebih dalam. Model yang gagal pada sesetengah ciri Raycast tetapi bukan yang lain adalah ketidakpadanan abilities: sambungan AI penggunaan-alatan gagal sementara chat biasa berfungsi apabila tools diisytiharkan pada model yang tiadanya, atau tidak pernah diisytiharkan pada yang memilikinya. Permintaan ditolak kerana saiz menunjuk kepada nilai context yang dinyatakan berlebihan. Dan ambil perhatian sempadan platform secara jujur: Custom Providers dikonfigurasikan pada Mac, dalam fail config setempat. Jika sebahagian penggunaan Raycast anda di tempat lain, semak manual untuk apa yang disokong ciri itu di situ sebelum menganggap keseragaman.

Siapa yang menghalakan Raycast AI melalui gateway.

• Pengguna kuasa yang hidup dalam launcher dan mahukan arahan AI pantas pada id katalog pantas tanpa langganan yang menentukan model mana yang boleh mereka sentuh.
• Orang yang sudah menghalakan alat editor dan terminal mereka melalui gateway dan mahukan launcher pada kunci yang sama, satu log penggunaan merentasi setiap permukaan.
• Pengguna yang mahukan model yang tidak dibawa senarai terbina-dalam Raycast, termasuk id DeepSeek dan GLM, diisytiharkan sekali dalam YAML dan tersedia di seluruh aplikasi.
• Pembina sambungan AI yang memerlukan model berkeupayaan-alatan tertentu di sebalik sambungan mereka, dipin mengikut id berbanding tertakluk kepada senarai dihoskan.
• Pembangun tanpa akses kepada pengebilan vendor tertentu. Akses berasaskan top-up tanpa keperluan kad menghapuskan kebergantungan pendaftaran setiap penyedia.

Sahkan endpoint dan nyahpepijat arahan pertama.

Jalankan curl model dahulu dan salin id daripada outputnya ke dalam YAML; menaip id daripada ingatan adalah punca utama ralat model-not-found di sini, kerana fail itu satu-satunya sumber model yang dimiliki Raycast. Kemudian hidupkan togol, sahkan pemilih menunjukkan nama yang anda isytiharkan, dan jalankan satu arahan AI pantas pada model pantas. Pemilih kosong adalah togol, nama fail, atau sintaks YAML. Ralat pengesahan adalah blok api_keys. Ralat not-found adalah ketidakpadanan id berbanding senarai yang baru anda curl. Arahan yang berfungsi dalam chat tetapi gagal dalam sambungan AI adalah pengisytiharan abilities pada model itu. Sebaik sahaja arahan mengalir, konsol APIsRouter menunjukkan model per permintaan, kiraan token, dan perbelanjaan. AI launcher adalah beratus-ratus permintaan kecil berbanding beberapa besar, dan log penggunaan adalah tempat corak itu menjadi nombor, per model, per hari, pada halaman yang sama dengan setiap alat lain yang anda halakan melalui 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"}]}'

Soalan lazim