Quelle clé de fournisseur d’IA utiliser avec Hermes Agent

Réponse courte. Hermes Agent n’inclut pas de modèle : il lui faut un compte chez un fournisseur d’IA. Sur PlayNHost, vous collez une clé API d’OpenAI, Anthropic, Google Gemini, xAI ou OpenRouter, et une seule clé suffit. Hermes Agent déduit le fournisseur de la clé, et vous choisissez le modèle depuis le chat avec /model. Si vous voulez beaucoup de modèles derrière une seule clé et une seule facture, utilisez OpenRouter. Votre fournisseur vous facture directement l’usage du modèle ; l’offre du serveur ne l’inclut pas.

Vérifié le 7 novembre 2026, valable pour Hermes Agent v0.23.0.

Ce guide s’appuie sur la documentation d’Hermes Agent sur les fournisseurs et la configuration, sur son code source de la v0.23.0 là où la documentation est muette, et sur le panel PlayNHost tel qu’il fonctionne aujourd’hui.

Les cinq clés que le panel accepte

Une clé API est facturée à l’usage. Un abonnement grand public, ce n’est pas la même chose : la documentation d’Hermes Agent dit qu’un forfait Claude Pro ne peut pas être utilisé via sa connexion, et que l’alternative prise en charge est une clé API Anthropic, facturée au token.

Laquelle choisir

• Vous payez déjà un fournisseur : utilisez cette clé.
• Vous voulez essayer plusieurs modèles : OpenRouter met de nombreux fournisseurs derrière une seule clé et une seule facture. La documentation d’Hermes Agent le présente comme « recommandé pour la flexibilité ».
• Vous pensez à une offre gratuite : la documentation d’Hermes Agent avertit qu’une clé Google Gemini gratuite peut être épuisée après une poignée de tours de l’agent, car un seul message de votre part peut déclencher plusieurs appels au modèle. D’autres petits quotas gratuits s’épuisent pour la même raison.
• Le modèle doit avoir un grand contexte. Hermes Agent exige au moins 64 000 tokens de contexte et refuse au démarrage les fenêtres plus petites. Vérifiez la fenêtre de contexte du modèle que vous choisissez, surtout s’il est petit.
• Pas sur PlayNHost : Nous Portal et les autres connexions (un compte ChatGPT, Claude Max ou SuperGrok) demandent hermes model ou hermes setup en ligne de commande, et les modèles locaux (Ollama, LM Studio) demandent un serveur de modèles que l’offre n’inclut pas. Le panel accepte les clés API.

Ajouter la clé sur PlayNHost

1. Ouvrez votre serveur sur panel.playnhost.com, puis l’onglet Agent.
2. Sous Fournisseur d’IA (« Une seule clé suffit. Chaque fournisseur facture sur votre propre compte ce que consomme votre agent. »), appuyez sur Définir sur la ligne de votre fournisseur, collez la clé et appuyez sur Enregistrer. La ligne n’affiche alors que les quatre derniers caractères. La clé est stockée chiffrée et n’est plus jamais affichée ; Remplacer et Retirer permettent de la changer plus tard.
3. Ajoutez un token de bot Telegram ou Discord si ce n’est pas déjà fait (Telegram, Discord), puis démarrez ou redémarrez l’agent : « Les changements s’appliquent au prochain démarrage de votre agent. »

La clé arrive chez Hermes Agent par son environnement, sous le nom du tableau. Hermes Agent en stocke une empreinte dans auth.json, pas la clé elle-même (nous l’avons vérifié sur un serveur de test).

Choisir le modèle depuis le chat

PlayNHost n’a pas de champ de modèle pour Hermes Agent : vous choisissez dans le chat, avec la commande propre à Hermes Agent.

• Envoyez /model à votre bot. Dans Telegram, cela ouvre un sélecteur : d’abord les fournisseurs pour lesquels vous avez une clé, puis leurs modèles. Le modèle actuel est affiché en haut.
• Si vous connaissez le nom du modèle, envoyez /model <name>. Ajoutez --global pour le conserver aussi pour les nouvelles conversations.
• /model ne bascule qu’entre les fournisseurs pour lesquels vous avez une clé. Pour un autre fournisseur, ajoutez sa clé sur la page Agent et redémarrez.

La documentation d’Hermes Agent ajoute une remarque sur les coûts : changer de modèle au milieu d’une longue conversation fait relire toute la conversation au plein tarif au message suivant, parce que le cache de prompt du fournisseur appartient à l’ancien modèle. Changez tôt, ou après /new.

Plusieurs clés à la fois

Vous pouvez en définir plusieurs. Quand aucun fournisseur n’est choisi dans les réglages d’Hermes Agent, son code de la v0.23.0 prend d’abord une clé OpenRouter ; sans elle, il prend le premier fournisseur ayant une clé dans sa propre liste intégrée. Pour éviter les surprises, gardez une seule clé, ou choisissez le fournisseur avec /model.

Garder la facture sous contrôle

• Votre fournisseur vous facture, pas nous. PlayNHost ne revend pas l’usage des modèles et ne l’ajoute pas à votre facture ; l’offre paie le serveur.
• Fixez une limite de dépense ou une alerte de budget chez votre fournisseur. Hermes Agent peut exécuter des tâches planifiées tout seul, et chaque exécution utilise votre clé pendant que vous ne regardez pas.
• Les tâches annexes utilisent votre modèle principal. Par défaut, Hermes Agent envoie ses tâches annexes (compression du contexte, lecture d’images, titres de session, évaluation du risque d’une commande) à votre modèle principal. Sa documentation note qu’avec un modèle coûteux, elles ajoutent un coût non négligeable.
• Vous seul pouvez lui écrire. Les listes d’ID utilisateur de la page Agent empêchent des inconnus de dépenser vos crédits.

Sur votre propre machine

Lancez hermes model pour choisir un fournisseur et un modèle (il demande la clé ou lance la connexion du fournisseur), ou mettez la clé dans ~/.hermes/.env :

OPENROUTER_API_KEY=sk-or-...

Puis redémarrez la gateway. Voir faire tourner Hermes Agent 24/7 : VPS ou hébergé, ou créez un serveur Hermes Agent et collez votre clé dans le panel.

PlayNHost n’est pas affilié à Nous Research. Hermes Agent est un logiciel open source sous licence MIT.