Magpie

Créez une clé API standard dédiée en suivant le guide d’authentification. Copiez un identifiant de modèle et son protocole pris en charge dans le catalogue des modèles. Sauvegardez la configuration de votre agent avant de changer de fournisseur.

Utilisez cette option pour les modèles qui prennent en charge Chat Completions. Remplacez les deux valeurs fictives avant d’exécuter la commande. La base url= se termine par /v1 ; Magpie y ajoute /chat/completions.

Utilisez cette option pour les modèles qui prennent en charge Anthropic Messages. La base anthropic= ne contient pas /v1 ; Magpie y ajoute /v1/messages.

Choisissez d’abord une seule option. Magpie refuse un second fournisseur utilisant la même clé. Pour conserver les deux fournisseurs, créez une clé RunAPI dédiée différente pour chacun. Conservez les clés RunAPI dans Magpie, en dehors de vos dépôts.

Démarrez Magpie et laissez sa passerelle fonctionner. Dans l’écran Agents, sélectionnez Claude Code ou Codex, puis choisissez le modèle sous votre fournisseur RunAPI. La CLI propose la même sélection. Exécutez une commande avec le fournisseur et l’identifiant de modèle choisis.

Dans un autre terminal, sélectionnez le modèle.

Pour l’option Anthropic, remplacez runapi-chat par runapi-anthropic. Magpie utilise provider/model localement et transmet l’identifiant de modèle d’origine à RunAPI. L’agent se connecte à Magpie sur 127.0.0.1:3425 ; il n’a pas besoin de la clé RunAPI. Codex utilise l’interface Responses locale, ce qui ne signifie pas que RunAPI reçoit une requête Responses. Ces options de fournisseur sélectionnent Chat Completions ou Messages côté RunAPI.

Vérifiez le fournisseur et le modèle sélectionné avec ces commandes, puis démarrez une nouvelle session d’agent et envoyez une courte invite.

Confirmez le modèle et la requête attendus dans les journaux d’utilisation RunAPI. Une réponse réussie de l’agent ne suffit pas à identifier le fournisseur qui l’a traitée. Les fonctions Test models, Detect APIs et le test de fournisseur de Magpie peuvent envoyer des requêtes d’inférence.

La configuration et les routes locales ont été vérifiées avec Magpie 0.1.1307 et Claude Code 2.1.295 sous Linux. Les deux options de fournisseur ont renvoyé une réponse fixe issue d’une fixture locale. L’inférence réelle RunAPI et l’inférence Codex n’ont pas été testées pour ce guide. Vérifiez le protocole et la prise en charge des outils du modèle sélectionné avant de l’utiliser avec un agent.

Si Magpie indique qu’un fournisseur a déjà été ajouté avec cette clé, réutilisez ce fournisseur ou utilisez une autre clé dédiée pour la seconde option. Cette erreur a été reproduite localement.

Un test avec une fixture locale a reproduit no model list avec connection refused lorsque le serveur configuré était arrêté. Vérifiez l’adresse et la disponibilité du serveur, puis utilisez models= avec l’identifiant exact du modèle. Laissez Magpie fonctionner pendant que les agents utilisent sa passerelle locale.

Claude Code a signalé unrecognized_model pour les identifiants de fixture, mais a tout de même renvoyé la réponse de la fixture. Si cet avertissement apparaît, vérifiez l’identifiant de modèle d’origine et la configuration du modèle dans Claude Code. La fixture n’a pas validé les limites de contexte, les appels d’outils ni la qualité du modèle.

Restaurez l’agent avant de supprimer son fournisseur. Ces commandes rétablissent la configuration précédente de chaque agent.

Supprimez uniquement les fournisseurs que vous avez ajoutés. Révoquez les clés RunAPI dédiées si vous n’en avez plus besoin. Restaurez votre sauvegarde si vous avez effectué d’autres modifications manuelles de configuration.

Consultez le démarrage rapide de l’API LLM pour les exemples de protocoles publics RunAPI et le catalogue des modèles pour les modèles pris en charge. La référence officielle de Magpie mentionne également une intégration Grok Build ; Grok Build n’a pas été testé pour ce guide.