Hoe gebruik je CometAPI in Raycast — een praktische gids

De AI-functies van Raycast laten je nu elke OpenAI-compatibele provider aansluiten via een aangepaste provider in providers.yaml. CometAPI is een gateway-API die honderden modellen aanbiedt via een REST-interface in OpenAI-stijl — zodat je Raycast kunt richten op https://api.cometapi.com/v1, je CometAPI-sleutel kunt toevoegen en CometAPI-modellen in Raycast AI kunt gebruiken (chat, opdrachten, extensies).

Wat is Raycast?

Raycast is een productiviteitslauncher voor macOS die opdrachten, scripts en — in toenemende mate — AI direct in je besturingssysteem integreert. Het AI-subsysteem biedt chat, AI-opdrachten, modelkeuze, extensies (tools waarmee LLM’s acties kunnen uitvoeren) en de mogelijkheid om lokale modellen (via Ollama) te gebruiken of via Bring Your Own Key / Custom Providers verbinding te maken met externe modelproviders. Raycast biedt een modelkiezer, AI-instellingen en een providers.yaml-template die gevorderde gebruikers kunnen aanpassen om OpenAI-compatibele backends toe te voegen.

Raycast rolt in 2025 BYOK (Bring Your Own Key) en Custom Providers uit, waardoor gebruikers Raycast AI met hun eigen API-sleutels en aangepaste endpoints kunnen gebruiken (voor flexibelere kostenbeheersing en privéprovideropties). Deze verandering is de technische basis die het integreren van CometAPI vanuit de Raycast-voorkeuren van eindgebruikers mogelijk maakt.

Hoe brengt Raycast AI naar gebruikers?

• Quick AI: directe prompts vanuit de launcher.
• AI Chat: conversatiesessies met bijlagen/context.
• AI Commands/Extensions: door ontwikkelaars gemaakte opdrachten of tools die LLM’s gebruiken.
  (Je beheert modellen, BYOK-sleutels en aangepaste providers via Instellingen → AI.)

Wat is CometAPI?

CometAPI is een API-aggregatieplatform dat honderden verschillende AI-modellen (tekst, beeld, audio, video, embeddings) aanbiedt via één REST-interface in OpenAI-stijl. In plaats van providerspecifieke clientcode te schrijven en te onderhouden voor OpenAI, Anthropic, Google, Midjourney, Runway, enz., roep je het CometAPI-endpoint aan en kies je het gewenste model via een modelstring. Die vereenvoudiging is krachtig voor experimentatie, kosten-/failover-routing en het centraliseren van facturatie en observability.

Belangrijkste mogelijkheden

• Tekst-/chatcompletions en assistants (chat-API’s in OpenAI-stijl).
• Eindpunten voor beeldgeneratie en beeldbewerking.
• Embeddings voor semantisch zoeken/RAG (retrieval-augmented generation).
• Audio (TTS en STT indien ondersteund door de onderliggende modellen).
• Videogeneratie voor gespecialiseerde backends (Sora, Veo, enz.).
  CometAPI levert ook SDK-snippets en aanvraagformaten in OpenAI-stijl, zodat het overzetten van bestaande code eenvoudig is.

Waarom dat nu relevant is: de markt verschuift naar gateway-API’s (handige enkele endpoints, goedkopere opties en modelkeuze). CometAPI is een van de commerciële spelers in dit domein, dus in combinatie met Raycasts ondersteuning voor aangepaste providers krijg je direct toegang tot een brede modelcatalogus vanuit je macOS-workflow.

Waarom CometAPI met Raycast integreren?

Kort antwoord: om elk model dat CometAPI aanbiedt direct vanuit je Raycast-AI-flow te gebruiken — Quick AI, AI Chat of aangepaste AI-opdrachten — zonder van tool te wisselen.

Voordelen:

• Gebruik goedkopere/snellere of gespecialiseerde modellen voor verschillende taken (samenvattingen, code, embeddings, beeldgeneratie) terwijl je in Raycast blijft.
• Gecentraliseerde facturatie en throttling via CometAPI, terwijl je de modelkeuze vanuit Raycast beheert.
• Minimale codewijzigingen: Raycast ondersteunt OpenAI-compatibele aangepaste providers en BYOK, dus CometAPI werkt vaak door eenvoudig de base_url en API-sleutel te vervangen.

(Deze mogelijkheden zijn mogelijk omdat Raycast aangepaste providers en BYOK ondersteunt, en CometAPI OpenAI-compatibele endpoints aanbiedt op https://api.cometapi.com/v1. )

Wat zijn goede use-cases voor deze integratie?

1. Hulp voor ontwikkelaars: code-uitleg, refactorsuggesties, generatie van unittests en PR-samenvattingen — roep aan vanuit Raycast en krijg inline antwoorden.
2. Notities en samenvattingen: selecteer tekst, voer een Raycast-opdracht uit om samen te vatten of actiepunten te extraheren met een CometAPI-samenvattingsmodel.
3. Documentatie schrijven: genereer functiedocumentatie of README-snippets via Raycast AI-opdrachten en houd iteraties lokaal.
4. Beeld-/multimediageneratie: als CometAPI afbeeldingsendpoints aanbiedt, kun je Raycast-extensies gebruiken die die endpoints aanroepen (bijv. de extensie “Generate Image from Prompt”) — handig voor snelle mock-ups.
5. Embeddings + semantisch zoeken: gebruik CometAPI-embeddings om lokale zoekworkflows aan te sturen — Raycast kan het front-end zijn dat je embeddingindex bevraagt via een klein lokaal script of een cloudfunctie.

Welke omgeving en voorwaarden moeten worden voorbereid?

Zorg vóór je begint dat het volgende klaarstaat:

Systeem & Raycast

• macOS (Raycast is macOS-native).
• Raycast geïnstalleerd. Gebruik bij voorkeur een recente versie die Custom Providers / BYOK ondersteunt (Raycast voegde BYOK toe in v1.100.0 en blijft Custom Providers uitrollen). Is je Raycast ouder, update dan.

Accounts & sleutels

• CometAPI-account en een geldige CometAPI API-sleutel (je gebruikt deze in Raycast-instellingen of omgevingsvariabelen). Zie het CometAPI-dashboard/de documentatie.

Optionele ontwikkeltools (voor testen of lokale ontwikkeling)

• Terminal (voor cURL).
• Python / Node / OpenAI-SDK’s als je de toegang tot CometAPI direct wilt testen voordat je het in Raycast koppelt. CometAPI ondersteunt direct gebruik via standaard SDK’s door base_url te overschrijven.

Machtigingen & netwerk

• Zorg dat Raycast en je macOS-netwerkbeleid HTTPS-aanroepen naar api.cometapi.com toestaan.
• Als je je in een bedrijfsnetwerk met proxy/firewall bevindt, controleer dan of api.cometapi.com bereikbaar is.

Lokale bestanden & locaties

De configuratie voor AI-providers van Raycast staat in providers.yaml onder de configuratiemap van Raycast (de app kan een providerstemplate tonen die je kunt kopiëren). Je bewerkt of maakt providers.yaml om aangepaste providers te definiëren.

Hoe integreer ik Raycast met CometAPI?

Het kernidee: registreer CometAPI als een aangepaste OpenAI-compatibele provider in Raycast, wijs Raycast naar https://api.cometapi.com/v1, en voeg je Comet-token toe aan Raycasts aangepaste API-sleutels.

Stap 1: haal je CometAPI-sleutel op

1. Meld je aan bij CometAPI en open de console/het dashboard.
2. Maak een API-token . Kopieer dit token en bewaar het veilig (of houd het bij de hand voor de volgende stap).

Stap 2: open de AI-instellingen van Raycast en schakel aangepaste providers in

1. In Raycast: Voorkeuren → AI.
2. Zoek “Custom Providers” (of “Custom OpenAI-compatible APIs”) en klik op Reveal Providers Config. Raycast opent Finder in de configuratiemap en geeft een templatebestand (meestal providers.template.yaml) dat je kunt kopiëren en hernoemen naar providers.yaml.

Stap 3: voeg een CometAPI-provider toe aan providers.yaml

Maak of bewerk het bestand providers.yaml. Het exacte schema dat Raycast verwacht kan per versie variëren, maar communitytemplates en de Raycast-handleiding tonen de gebruikelijke structuur: een lijst met providernotities met id, name, base_url en optioneel een blok models. Hieronder staat een veilige, werkende voorbeeldconfiguratie om CometAPI te registreren als een OpenAI-co

Belangrijke opmerkingen

• Vervang YOUR_COMETAPI_KEY door een veilige verwijzing — plak het token (voor persoonlijk gebruik) of, beter: sla het op in macOS Keychain / de beveiligde velden van Raycast indien ondersteund.
• base_url is de belangrijke regel: wijs deze naar https://api.cometapi.com/v1. Raycast gebruikt die basis-URL voor OpenAI-compatibele aanroepen.
• Je hoeft niet per se alle modellen vooraf te vermelden — Raycast kan modellijsten ophalen van een correct geïmplementeerde OpenAI-stijl GET /v1/models-eindpunt als je provider die aanbiedt. Als CometAPI een modellenlijst aanbiedt, kan Raycast de beschikbare modellen verversen en tonen.

Stap 4: modellen verversen en testen

• Terug in Raycast moet je mogelijk de app herstarten of een “Refresh Models”-opdracht gebruiken (afhankelijk van de versie) zodat Raycast modellen van de nieuwe provider ophaalt en de modelkiezer vult. Ik raad aan te verversen of te herstarten als modellen niet verschijnen.
• Gebruik een eenvoudige Quick AI-prompt, kies het model van CometAPI in de modelkiezer en voer een testprompt uit.

Best practices bij het gebruik van CometAPI in Raycast

Beveiligingsbest practices: Zet nooit tokens hardcoded in een gedeelde providers.yaml. Geef de voorkeur aan de beveiligde velden van Raycast of macOS Keychain, of injecteer sleutels lokaal via omgevingsvariabelen als je een lokale proxy gebruikt. Lees de privacydocumenten van zowel CometAPI als Raycast bij gevoelige data.

Betrouwbaarheid & prestaties: Test de latentie van de modellen die je wilt gebruiken — gateway-API’s kunnen variabele routing hebben. Voor interactieve workflows (autosamenvattingen, snelle opvragingen) geef de voorkeur aan kleinere, snellere modellen. Voor diepere redeneertaken kies je de modellen met hogere context.

Kostenbeheersing: Gebruik modelselectie actief: kies lichte modellen voor korte taken, modellen met hoge capaciteit voor zwaar redeneren. Volg gebruik op het CometAPI-dashboard en stel budgetalerts in. Overweeg programmatische prompts om tokengebruik te reduceren (bijv. kortere systeemberichten, efficiënt contextbeheer).

Prompt engineering & UX: Bij het maken van Raycast AI Commands (dupliceer een ingebouwde opdracht en pas de prompt aan), houd prompts deterministisch voor utility-opdrachten (samenvatten, triage, zoeken) en opener voor ideatieworkflows. Ingebouwde opdrachten kopiëren en prompts aanpassen is de aanbevolen manier.

Hoe los je veelvoorkomende problemen op?

Modellen worden niet weergegeven in Raycast: Zorg dat providers.yaml van Raycast exact in de map staat die door “Reveal Providers Config” wordt getoond. Gebruik de template als basis en herstart Raycast. Een herstart of “Refresh Models” helpt.

401 / ongeldig token: Controleer of je CometAPI-token geldig en niet verlopen is. Probeer de curl-test hierboven. Controleer of je een Bearer-token gebruikt en of de header Authorization correct is.

Modelerrors of onverenigbare responsvormen: CometAPI streeft naar OpenAI-compatibiliteit, maar er kunnen randgevallen zijn (model-ID’s, streaminggedrag). Als Raycast een specifiek streamingformaat verwacht en CometAPI een iets andere vorm terugstuurt, probeer eerst een niet-streamende call en neem zo nodig contact op met de support van CometAPI.

Conclusie

CometAPI geeft je uniforme, multivendor-toegang tot veel modellen (tekst, beeld, audio, video) en laat teams facturatie en routing centraliseren. Raycast biedt een directe, toetsenbord-first plek om die modellen aan te roepen in de context van je desktopworkflows. Samen maken ze model-experimentatie en desktopautomatisering frictieloos — je kunt modellen wisselen voor kosten of kwaliteit, je sleutels lokaal houden en gebruikmaken van dezelfde vertrouwde patronen in OpenAI-stijl die je al in scripts en apps hanteert.

Als je meteen wilt beginnen, verken dan de mogelijkheden van de modellen (Gemini 3 Pro Preview API enz.) van CometAPI in de Playground en raadpleeg de API-gids voor gedetailleerde instructies. Zorg ervoor dat je bent aangemeld bij CometAPI en de API-sleutel hebt verkregen voordat je toegang krijgt. CometAPI bieden een prijs die veel lager is dan de officiële prijs om je te helpen integreren.

Klaar om te starten?→ Gebruik CometAPI vandaag nog in Raycast !

Wil je meer tips, gidsen en nieuws over AI? Volg ons op VK, X en Discord!