Mettez des modèles du catalogue dans Raycast AI avec un seul providers.yaml.

Réponse rapide : activez Custom Providers, éditez un seul fichier.

Le chemin de Raycast pour les endpoints compatibles OpenAI est la fonctionnalité Custom Providers, destinée aux utilisateurs avancés et désactivée par défaut. Activez-la en bas de la section AI dans les réglages Raycast, utilisez Reveal Providers Config pour ouvrir le dossier de config, et copiez le providers.template.yaml fourni vers providers.yaml. Le fichier vit à ~/.config/raycast/ai/providers.yaml. Chaque entrée de fournisseur prend un id, un nom d'affichage, un base_url, et un bloc api_keys ; chaque modèle que vous voulez dans le sélecteur est déclaré explicitement avec son id, un nom d'affichage, et sa fenêtre de contexte, plus un bloc abilities décrivant ce que Raycast peut lui demander. La forme de base_url suit la même convention que les exemples de modèles locaux intégrés, qui pointent vers une racine /v1, donc la valeur d'APIsRouter est https://api.apisrouter.com/v1. Le fichier contient des identifiants, donc traitez-le comme n'importe quel fichier de secrets.

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

Deux fonctionnalités Raycast qui se ressemblent, et ne le sont pas.

Raycast documente deux façons d'apporter votre propre accès IA, et chercher l'une fait invariablement remonter l'autre, donc la distinction mérite d'être posée clairement. Bring Your Own Keys, la page BYOK du manuel Raycast, connecte votre clé personnelle Anthropic, Google ou OpenAI (OpenRouter sur iOS) à Raycast AI. C'est la fonctionnalité la plus simple, documentée comme fonctionnant sans abonnement Pro, mais ce n'est pas un endpoint personnalisé : les requêtes passent par les serveurs de Raycast pour l'unification de l'API, et le manuel est explicite sur le fait que seuls les modèles déjà disponibles dans Raycast AI sont accessibles. Une clé de passerelle ne s'y branche pas, parce que BYOK ne demande jamais d'URL. Custom Providers est la fonctionnalité que configure cette page : votre propre base_url, votre propre clé, vos propres modèles déclarés, des requêtes qui vont où vous les pointez. C'est le chemin pour une passerelle multi-fournisseurs, pour des serveurs locaux, et pour tout modèle que ne porte pas la liste intégrée de Raycast. Le compromis, c'est l'explicitude : Raycast ne récupère pas la liste de modèles de l'endpoint pour vous (cette commodité est une demande de fonctionnalité en attente), donc le sélecteur montre exactement ce que déclare votre YAML, ni plus ni moins.

Déclarer les modèles honnêtement : ids, contexte, abilities.

Comme il n'y a pas d'auto-découverte, le YAML est un contrat, et chaque champ y fait un vrai travail. L'id de modèle doit correspondre exactement au listing /v1/models de la passerelle ; c'est ce qui voyage dans la requête. Le name n'est que l'étiquette que montre Raycast. La valeur context indique à Raycast combien d'historique de conversation il peut empiler dans une requête, donc la sous-estimer gaspille de la capacité et la surestimer produit des requêtes que le modèle rejette ; utilisez la fenêtre documentée pour l'id que vous déclarez. Le bloc abilities est celui que les gens ratent. Il déclare sur quoi Raycast peut compter : contrôle de la température, entrée vision, messages système, usage d'outils, effort de raisonnement. Déclarer une capacité que le modèle n'a pas produit des échecs d'exécution déroutants à l'intérieur des fonctionnalités Raycast plutôt que des erreurs propres, et omettre une capacité que le modèle a désactive silencieusement le comportement Raycast correspondant. Commencez minimal, température plus outils pour les modèles que vous utiliserez avec des extensions IA, et ajoutez des capacités au fur et à mesure que vous les confirmez contre la documentation du modèle. Une extension Raycast maintenue par la communauté existe spécifiquement pour gérer ce fichier depuis une UI, avec des sauvegardes automatiques avant chaque changement, utile à savoir si le YAML à la main n'est pas votre préférence. Dans tous les cas, Raycast lit le fichier depuis le disque, donc après édition, laissez un moment aux réglages AI ou basculez la fonctionnalité pour vous assurer que le sélecteur reflète le fichier actuel.

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

Choisir des modèles pour un launcher.

Comme chaque modèle déclaré facture via la même clé, la boucle de comparaison est un changement dans le sélecteur : faites tourner les mêmes commandes rapides sur deux ids pendant une journée, puis lisez la dépense par modèle dans la console et gardez celui qui a mérité sa place.

• L'IA du launcher est un travail en rafales : résumer ceci, réécrire cela, expliquer la sélection. claude-haiku-4-5-20251001 et gemini-3.5-flash répondent avant que l'animation de la fenêtre ne se termine, ce qui est le ressenti qu'attendent les utilisateurs de Raycast.
• Les sessions AI Chat et la rédaction longue justifient claude-sonnet-4-6 ou gpt-5.5 ; déclarez-les aux côtés du niveau rapide et changez par tâche dans le sélecteur.
• Les extensions IA qui appellent des outils ont besoin d'un modèle avec un usage d'outils fiable, et du bloc abilities déclaré en conséquence ; claude-sonnet-4-6 est le premier choix sûr là.
• deepseek-v4-flash est le choix de volume pour les utilisateurs qui câblent l'IA dans chaque champ de texte qu'ils touchent ; de petites completions constantes s'additionnent, et le niveau rapide garde l'habitude invisible sur le solde.
• Déclarez peu de modèles délibérément plutôt que beaucoup spéculativement : chaque entrée est une ligne du sélecteur que vous parcourez, et le YAML est facile à étendre le jour où vous avez besoin d'un autre id.

Paiement à l'usage · en dessous du tarif officiel

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

Modes d'échec spécifiques à Raycast.

Configurer BYOK alors que vous vouliez Custom Providers est l'erreur de premier niveau, et ce n'est pas votre faute : les fonctionnalités partagent un espace de recherche. Si le flux dans lequel vous êtes demande une clé de fournisseur mais jamais une URL, vous êtes dans BYOK, et la passerelle n'y a pas sa place. Ressortez vers Settings, AI, et le bascule Custom Providers en bas. Le fichier ignoré signifie généralement que le bascule de la fonctionnalité est désactivé, que le fichier s'appelle encore providers.template.yaml, ou que le YAML a une erreur de syntaxe, auquel cas Raycast n'a rien de valide à charger et le sélecteur ne montre simplement aucun modèle personnalisé. Validez le YAML avant de soupçonner quelque chose de plus profond. Un modèle qui échoue sur certaines fonctionnalités Raycast mais pas d'autres est une discordance d'abilities : les extensions IA qui utilisent des outils échouent tandis que le chat simple fonctionne quand tools a été déclaré sur un modèle qui ne l'a pas, ou jamais déclaré sur un qui l'a. Des requêtes rejetées pour la taille pointent vers une valeur context surestimée. Et notez honnêtement la frontière de plateforme : Custom Providers se configure sur le Mac, dans un fichier de config local. Si une partie de votre usage de Raycast est ailleurs, vérifiez le manuel pour ce que la fonctionnalité y supporte avant de supposer une parité.

Qui route Raycast AI via une passerelle.

• Les utilisateurs avancés qui vivent dans le launcher et veulent des commandes IA rapides sur des ids de catalogue rapides sans qu'un abonnement décide quels modèles ils peuvent toucher.
• Les personnes qui routent déjà leurs outils d'éditeur et de terminal via une passerelle et veulent le launcher sur la même clé, un seul journal d'usage à travers chaque surface.
• Les utilisateurs qui veulent des modèles que ne porte pas la liste intégrée de Raycast, ids DeepSeek et GLM inclus, déclarés une fois en YAML et disponibles partout dans l'app.
• Les développeurs d'extensions IA qui ont besoin d'un modèle spécifique capable d'outils derrière leur extension, fixé par id plutôt que soumis à une liste hébergée.
• Les développeurs sans accès à la facturation d'un fournisseur donné. Un accès basé sur la recharge, sans exigence de carte, supprime la dépendance à une inscription par fournisseur.

Vérifiez l'endpoint et déboguez la première commande.

Lancez d'abord le curl des modèles et copiez les ids depuis sa sortie dans le YAML ; taper les ids de mémoire est la cause principale des erreurs model-not-found ici, parce que le fichier est la seule source de modèles que possède Raycast. Activez ensuite le bascule, confirmez que le sélecteur montre vos noms déclarés, et lancez une commande IA rapide sur le modèle rapide. Un sélecteur vide, c'est le bascule, le nom de fichier, ou la syntaxe YAML. Une erreur d'authentification, c'est le bloc api_keys. Une erreur not-found est une discordance d'id contre le listing que vous venez de curler. Une commande qui fonctionne dans le chat mais échoue dans une extension IA, c'est la déclaration abilities sur ce modèle. Une fois que les commandes circulent, la console APIsRouter affiche le modèle par requête, le nombre de tokens et la dépense. L'IA du launcher, ce sont des centaines de petites requêtes plutôt que quelques grosses, et le journal d'usage est là où ce motif devient un chiffre, par modèle, par jour, sur la même page que chaque autre outil que vous routez via la passerelle.

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

Questions fréquentes