Zet catalogusmodellen in Raycast AI met één providers.yaml.

Snel antwoord: schakel Custom Providers in, bewerk één bestand.

Het pad van Raycast voor OpenAI-compatibele endpoints is de Custom Providers-functie, gericht op gevorderde gebruikers en standaard uitgeschakeld. Schakel hem in onderaan de AI-sectie in Raycast-instellingen, gebruik Reveal Providers Config om de configmap te openen, en kopieer de meegeleverde providers.template.yaml naar providers.yaml. Het bestand leeft op ~/.config/raycast/ai/providers.yaml. Elke providervermelding neemt een ID, een weergavenaam, een base_url, en een api_keys-blok; elk model dat je in de kiezer wilt, wordt expliciet verklaard met zijn ID, een weergavenaam, en zijn contextvenster, plus een abilities-blok dat beschrijft wat Raycast van hem mag vragen. De vorm van base_url volgt dezelfde conventie als de ingebouwde lokale-modelvoorbeelden, die naar een /v1-root wijzen, dus de waarde van APIsRouter is https://api.apisrouter.com/v1. Het bestand bevat credentials, behandel het dus als elk secretsbestand.

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

Twee Raycast-functies die op elkaar lijken, en dat niet zijn.

Raycast documenteert twee manieren om je eigen AI-toegang mee te brengen, en zoeken naar de ene brengt betrouwbaar de andere naar boven, dus is het onderscheid het waard om duidelijk te stellen. Bring Your Own Keys, de BYOK-pagina in de Raycast-handleiding, verbindt je persoonlijke Anthropic-, Google- of OpenAI-sleutel (OpenRouter op iOS) met Raycast AI. Het is de eenvoudigere functie, gedocumenteerd als werkend zonder Pro-abonnement, maar het is geen aangepast endpoint: verzoeken routeren via de servers van Raycast voor API-unificatie, en de handleiding is expliciet dat alleen modellen die al beschikbaar zijn in Raycast AI toegankelijk zijn. Een gatewaysleutel past daar niet in, omdat BYOK nooit om een URL vraagt. Custom Providers is de functie die deze pagina configureert: je eigen base_url, je eigen sleutel, je eigen verklaarde modellen, verzoeken gaan waar jij ze wijst. Het is het pad voor een multi-vendor-gateway, voor lokale servers, en voor elk model dat de ingebouwde lijst van Raycast niet draagt. De prijs is expliciteit, Raycast haalt de modellijst van het endpoint niet automatisch voor je op (dat gemak is een openstaand featureverzoek), dus de kiezer toont exact wat je YAML verklaart, niets meer en niets minder.

Modellen eerlijk verklaren: ID's, context, abilities.

Omdat er geen auto-discovery is, is de YAML een contract, en elk veld daarin doet echt werk. Het model-ID moet exact overeenkomen met de /v1/models-lijst van de gateway; het is wat meereist in het verzoek. De naam is alleen het label dat Raycast toont. De contextwaarde vertelt Raycast hoeveel gespreksgeschiedenis het in een verzoek mag inpakken, dus onderschatting verspilt capaciteit en overschatting produceert verzoeken die het model afwijst; gebruik het gedocumenteerde venster voor het ID dat je verklaart. Het abilities-blok is waar mensen het fout doen. Het verklaart waarop Raycast mag vertrouwen: temperatuurregeling, visie-invoer, systeemberichten, tool use, redeneerinspanning. Een ability verklaren die het model niet heeft, produceert verwarrende runtime-fouten binnen Raycast-functies in plaats van schone fouten, en er een weglaten die het model wel heeft, schakelt stilletjes het bijbehorende Raycast-gedrag uit. Begin minimaal, temperatuur plus tools voor de modellen die je zult gebruiken met AI-extensies, en voeg abilities toe naarmate je ze bevestigt tegen de documentatie van het model. Er bestaat een community-onderhouden Raycast-extensie specifiek om dit bestand vanuit een UI te beheren, met automatische back-ups voor elke wijziging, het waard om te weten als YAML-met-de-hand niet je voorkeur is. Hoe dan ook, Raycast leest het bestand van schijf, dus geef na het bewerken de AI-instellingen een moment of schakel de functie om te zorgen dat de kiezer het huidige bestand weerspiegelt.

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

Modellen kiezen voor een launcher.

Omdat elk verklaard model factureert via dezelfde sleutel, is de vergelijkingslus een kiezerwissel: draai dezelfde snelle commando's op twee ID's gedurende een dag, lees dan de uitgaven per model in de console en behoud degene die zijn plek heeft verdiend.

• Launcher-AI is burstwerk: vat dit samen, herschrijf dat, leg de selectie uit. claude-haiku-4-5-20251001 en gemini-3.5-flash keren terug voordat de vensteranimatie klaar is, wat het gevoel is dat Raycast-gebruikers verwachten.
• AI Chat-sessies en lang opstellen verdienen claude-sonnet-4-6 of gpt-5.5; verklaar ze naast de snelle laag en wissel per taak in de kiezer.
• AI-extensies die tools aanroepen hebben een model nodig met betrouwbaar tool use, en het abilities-blok verklaard om te matchen; claude-sonnet-4-6 is daar de veilige eerste keuze.
• deepseek-v4-flash is de volumekeuze voor gebruikers die AI in elk tekstveld bekabelen dat ze aanraken; constante kleine completions stapelen op, en de snelle laag houdt de gewoonte onzichtbaar op het saldo.
• Verklaar weinig modellen bewust in plaats van vele speculatief: elke vermelding is een kiezerrij waar je langsscrolt, en de YAML is eenvoudig uit te breiden de dag dat je nog een ID nodig hebt.

Betaal naar gebruik · onder officiële prijzen

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

Faalmodi specifiek voor Raycast.

BYOK configureren terwijl je Custom Providers bedoelde is de vergissing op het hoogste niveau, en het is niet je schuld: de functies delen een zoekruimte. Als de flow waarin je zit vraagt om een leverancierssleutel maar nooit een URL, zit je in BYOK, en de gateway hoort daar niet thuis. Ga terug naar Instellingen, AI, en de Custom Providers-schakelaar onderaan. Het bestand dat wordt genegeerd betekent meestal dat de featureschakelaar uit staat, het bestand nog steeds providers.template.yaml heet, of de YAML een syntaxfout heeft, in welk geval Raycast niets geldigs heeft om te laden en de kiezer simpelweg geen aangepaste modellen toont. Valideer de YAML voordat je iets dieper vermoedt. Een model dat op sommige Raycast-functies fouten geeft maar niet op andere is een abilities-mismatch: tool-gebruikende AI-extensies falen terwijl gewone chat werkt wanneer tools was verklaard op een model dat het mist, of nooit verklaard op een dat het wel heeft. Verzoeken afgewezen om grootte wijzen naar een overschatte contextwaarde. En let eerlijk op de platformgrens: Custom Providers wordt geconfigureerd op de Mac, in een lokaal configbestand. Als een deel van je Raycast-gebruik elders is, controleer de handleiding voor wat de functie daar ondersteunt voordat je pariteit aanneemt.

Wie routeert Raycast AI via een gateway.

• Poweruser die in de launcher leven en snelle AI-commando's op snelle catalogus-ID's willen zonder dat een abonnement beslist welke modellen ze mogen aanraken.
• Mensen die hun editor en terminaltools al via een gateway routeren en de launcher op dezelfde sleutel willen, één gebruikslogboek over elk oppervlak.
• Gebruikers die modellen willen die de ingebouwde lijst van Raycast niet draagt, DeepSeek- en GLM-ID's inbegrepen, eenmaal verklaard in YAML en overal in de app beschikbaar.
• Bouwers van AI-extensies die een specifiek tool-capabel model achter hun extensie nodig hebben, vastgepind op ID in plaats van onderworpen aan een gehoste lijst.
• Developers zonder toegang tot de facturering van een bepaalde leverancier. Toegang op basis van opwaarderen zonder kaartvereiste verwijdert de aanmeldingsafhankelijkheid per provider.

Verifieer het endpoint en debug het eerste commando.

Draai eerst de models-curl en kopieer ID's uit de output naar de YAML; ID's uit het geheugen typen is de belangrijkste oorzaak van model-not-found-fouten hier, omdat het bestand de enige modelbron is die Raycast heeft. Schakel dan de toggle in, bevestig dat de kiezer je verklaarde namen toont, en draai één snel AI-commando op het snelle model. Een lege kiezer is de toggle, de bestandsnaam, of de YAML-syntax. Een authenticatiefout is het api_keys-blok. Een not-found-fout is een ID-mismatch tegen de lijst die je zojuist hebt gecurld. Een commando dat werkt in chat maar faalt in een AI-extensie is de abilities-verklaring op dat model. Zodra commando's stromen, toont de APIsRouter-console model per verzoek, tokenaantallen en uitgaven. Launcher-AI is honderden kleine verzoeken in plaats van een paar grote, en het gebruikslogboek is waar dat patroon een cijfer wordt, per model, per dag, op dezelfde pagina als elke andere tool die je via de gateway routeert.

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

Veelgestelde vragen