Ilagay ang mga model ng katalogo sa Raycast AI gamit ang iisang providers.yaml.

Mabilisang sagot: paganahin ang Custom Providers, i-edit ang isang file.

Ang landas ng Raycast para sa mga OpenAI-compatible endpoint ay ang Custom Providers feature, nakatutok sa advanced na users at naka-disable bilang default. Paganahin ito sa ilalim ng AI section sa Raycast Settings, gamitin ang Reveal Providers Config para buksan ang config folder, at kopyahin ang kasamang providers.template.yaml patungong providers.yaml. Nasa ~/.config/raycast/ai/providers.yaml ang file. Ang bawat provider entry ay may id, display name, base_url, at isang api_keys block; ang bawat model na gusto mo sa picker ay tahasang idineklara kasama ang id nito, display name, at context window, kasama ang isang abilities block na naglalarawan kung ano ang maaaring hilingin ng Raycast dito. Sinusunod ng hugis ng base_url ang parehong convention ng built-in na mga halimbawa ng local-model, na nakaturo sa isang /v1 root, kaya ang value para sa APIsRouter ay https://api.apisrouter.com/v1. Naglalaman ng credentials ang file, kaya trato ito tulad ng anumang secrets file.

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

Dalawang feature ng Raycast na magkatunog pero hindi magkatulad.

May dalawang paraan ang Raycast na dokumentado para dalhin ang sarili mong AI access, at ang paghahanap sa isa ay lagi ring naglalabas ng kabila, kaya sulit ilinaw ang pagkakaiba. Ang Bring Your Own Keys, ang BYOK page sa manual ng Raycast, ay kumokonekta sa personal mong Anthropic, Google, o OpenAI key (OpenRouter sa iOS) patungo sa Raycast AI. Ito ang mas simpleng feature, dokumentado bilang gumagana kahit walang Pro subscription, pero hindi ito custom endpoint: dumadaan ang mga request sa mga server ng Raycast para sa API unification, at malinaw na sinasabi ng manual na tanging mga model na nasa Raycast AI na ang maaabot. Hindi maikakabit ang isang gateway key doon, dahil hindi kailanman humihiling ng URL ang BYOK. Ang Custom Providers ang feature na kino-configure ng pahinang ito: sarili mong base_url, sarili mong key, sarili mong idineklarang mga model, pupunta ang mga request kung saan mo inituro. Ito ang landas para sa isang multi-vendor na gateway, para sa mga local server, at para sa anumang model na wala sa built-in na listahan ng Raycast. Ang kapalit ay ang pagiging tahasan, hindi kinukuha ng Raycast ang model list ng endpoint para sa iyo (isang standing feature request pa rin ang convenience na iyon), kaya ipinapakita ng picker eksakto ang idineklara ng YAML mo, wala nang iba pa.

Tapat na pagdeklara ng mga model: ids, context, abilities.

Dahil walang autodiscovery, ang YAML ay isang kontrata, at bawat field dito ay may tunay na trabaho. Dapat tumugma ang model id sa listahan ng /v1/models ng gateway nang eksakto; ito ang naglalakbay sa request. Ang name ay label lamang na ipinapakita ng Raycast. Sinasabihan ng context value ang Raycast kung gaano karaming conversation history ang maaari nitong isama sa isang request, kaya ang pag-undervalue nito ay nag-aaksaya ng kapasidad at ang pag-overvalue nito ay gumagawa ng mga request na tinatanggihan ng model; gamitin ang naka-document na window para sa id na idineklara mo. Ang abilities block ang kadalasang nagkakamalian. Idineklara nito kung ano ang maaaring asahan ng Raycast: temperature control, vision input, system messages, tool use, reasoning effort. Ang pagdeklara ng isang ability na wala sa model ay gumagawa ng nakakalitong runtime failures sa loob ng mga feature ng Raycast sa halip na malinaw na error, at ang pagkakaligtaan ng isang totoong ability ay tahimik na nagdi-disable sa katumbas na behavior ng Raycast. Magsimula nang minimal, temperature kasama ang tools para sa mga model na gagamitin mo sa AI extensions, at magdagdag ng abilities habang kinukumpirma mo ang mga ito laban sa dokumentasyon ng model. May community-maintained na Raycast extension na partikular na ginawa para pamahalaan ang file na ito mula sa isang UI, kasama ang automatic backups bago ang bawat pagbabago, sulit malaman kung hindi mo gustong mano-manong i-edit ang YAML. Sa alinmang paraan, binabasa ng Raycast ang file mula sa disk, kaya pagkatapos mag-edit, bigyan ng saglit ang AI settings o i-toggle ang feature para masiguro na sinasalamin ng picker ang kasalukuyang file.

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

Pagpili ng mga model para sa isang launcher.

Dahil sinisingil sa parehong key ang bawat idineklarang model, isang picker switch lang ang comparison loop: patakbuhin ang parehong mabilis na command sa dalawang id sa loob ng isang araw, pagkatapos basahin ang per-model spend sa console at panatilihin ang nagdesisyon na sulit ang lugar nito.

• Burst work ang Launcher AI: buodin ito, isulat muli iyon, ipaliwanag ang selection. Bumabalik ang claude-haiku-4-5-20251001 at gemini-3.5-flash bago pa matapos ang window animation, ang siyang feel na inaasahan ng mga user ng Raycast.
• Karapat-dapat sa claude-sonnet-4-6 o gpt-5.5 ang mga AI Chat session at mahabang pagsusulat; ideklara ang mga ito kasama ng fast tier at magpalit per task sa picker.
• Kailangan ng AI extensions na tumatawag ng tools ng isang model na may maaasahang tool use, at ang abilities block na idineklara upang tumugma; ang claude-sonnet-4-6 ang ligtas na unang pili roon.
• Ang deepseek-v4-flash ang volume pick para sa mga user na sinasama ang AI sa bawat text field na hinihipo nila; nagdaragdag ang patuloy na maliliit na completions, at pinapanatili ng fast tier na hindi nakikita ang ugaling ito sa balance.
• Magdeklara ng kaunting model nang sinasadya kaysa marami nang haka-haka: bawat entry ay isang row sa picker na kailangang i-scroll lagpasan, at madaling palawigin ang YAML sa araw na kailangan mo ng isa pang id.

Pay-as-you-go · mas mababa sa opisyal na presyo

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

Mga failure mode na specific sa Raycast.

Ang pag-configure ng BYOK kung Custom Providers naman ang gusto mo ang pinakakaraniwang pagkakamali, at hindi ito kasalanan mo: nagbabahagi ang mga feature ng parehong search space. Kung ang flow na kinaroroonan mo ay humihingi ng vendor key pero hindi kailanman ng URL, nasa BYOK ka, at hindi doon nakalagay ang gateway. Bumalik sa Settings, AI, at ang Custom Providers toggle sa ilalim. Ang file na hindi pinapansin ay karaniwang nangangahulugan na naka-off ang feature toggle, providers.template.yaml pa rin ang pangalan ng file, o may syntax error ang YAML, kung saan wala talagang valid na maloload ang Raycast at ang picker ay simpleng walang ipinapakitang custom models. I-validate muna ang YAML bago mag-suspetsa ng mas malalim na dahilan. Ang isang model na nag-e-error sa ibang Raycast feature pero hindi sa iba ay isang abilities mismatch: nabibigo ang mga tool-using AI extensions habang gumagana ang plain chat kapag idineklara ang tools sa isang model na wala nito, o hindi kailanman idineklara sa isang mayroon nito. Ang mga request na tinatanggihan dahil sa size ay tumuturo sa isang overstated na context value. At tapat na tandaan ang platform boundary: kino-configure ang Custom Providers sa Mac, sa isang local config file. Kung nasa ibang lugar ang bahagi ng paggamit mo ng Raycast, tingnan ang manual kung ano ang suportado ng feature doon bago ipagpalagay na pareho ito.

Sino ang nagru-route ng Raycast AI sa pamamagitan ng isang gateway.

• Mga power user na nakatira sa launcher at gustong magpatakbo ng quick AI commands sa mabilis na id ng katalogo nang walang subscription na nagdedesisyon kung aling mga model ang maaari nilang hipuin.
• Mga taong nag-ruruta na ng editor at terminal tools nila sa pamamagitan ng isang gateway at gustong ikabit ang launcher sa parehong key, isang usage log sa bawat surface.
• Mga user na gustong gamitin ang mga model na wala sa built-in na listahan ng Raycast, kasama ang DeepSeek at GLM ids, idineklara nang isang beses sa YAML at magagamit saanman sa app.
• Mga builder ng AI extension na kailangan ng isang tiyak na tool-capable na model sa likod ng extension nila, naka-pin sa pamamagitan ng id sa halip na sumasailalim sa isang hosted na listahan.
• Mga developer na walang access sa billing ng isang partikular na vendor. Ang top-up based na access na walang kailangang card ay inaalis ang per-provider na sign-up dependency.

I-verify ang endpoint at i-debug ang unang command.

Patakbuhin muna ang models curl at kopyahin ang mga id mula sa output nito patungo sa YAML; ang pag-type ng mga id mula sa memorya ang pangunahing sanhi ng mga model-not-found error dito, dahil ang file ang tanging pinagmulan ng model na mayroon ang Raycast. Pagkatapos ay paganahin ang toggle, kumpirmahin na ipinapakita ng picker ang mga idineklarang pangalan mo, at patakbuhin ang isang mabilis na AI command sa fast model. Ang isang walang laman na picker ay ang toggle, ang filename, o ang syntax ng YAML. Ang authentication error ay ang api_keys block. Ang not-found error ay isang id mismatch laban sa listahan na kaka-curl mo lang. Ang isang command na gumagana sa chat pero nabibigo sa isang AI extension ay ang abilities declaration sa model na iyon. Kapag dumadaloy na ang mga command, ipinapakita ng APIsRouter console ang per-request na model, token counts, at gastos. Daan-daang maliliit na request ang Launcher AI sa halip na iilang malalaki, at ang usage log ang lugar kung saan nagiging numero ang pattern na iyon, per model, per araw, sa parehong page ng bawat ibang tool na iniruruta mo sa 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"}]}'

Mga madalas itanong