# Configurer Hermes Agent avec OmniaKey : endpoint OpenAI-compatible > Connectez Hermes Agent à un endpoint OmniaKey compatible avec OpenAI. Utilisez hermes model ou config.yaml, changez de modèle et évitez les erreurs 404. - Canonical HTML: https://omniakey.com/fr/blog/hermes-setup - Markdown: https://omniakey.com/fr/blog/hermes-setup.md - Published: 2026-05-24 (updated 2026-10-30) - Author: Kiki, COO at OmniaKey - Language: fr - Category: Guide - Reading time: 4 min - All posts: https://omniakey.com/blog/llms.txt --- Mis à jour le 30 octobre 2026 : quatre erreurs de configuration courantes de Hermes indiquent désormais le symptôme, la cause et la solution, d'après la documentation officielle de Hermes Agent. Pour **configurer Hermes Agent API**, ajoutez un endpoint personnalisé compatible avec OpenAI. Hermes Agent de Nous Research peut ensuite passer de Claude à GPT, Gemini ou Grok en changeant l'ID du modèle. ## Méthode rapide : `hermes model` ```bash hermes model ``` Choisissez **Custom endpoint (self-hosted / VLLM / etc.)**, puis saisissez : - **Base URL :** `https://api.omniakey.com/v1` - **API key :** votre clé OmniaKey - **Model :** par exemple `claude-opus-4-8` > Arrêtez la Base URL à `/v1`. Hermes ajoute `/chat/completions`; un chemin complet ou un slash final provoque souvent un 404. ## Modifier `config.yaml` Pour une configuration persistante avec plusieurs modèles, utilisez `~/.hermes/config.yaml` : ```yaml model: provider: custom base_url: https://api.omniakey.com/v1 api_key: your-omniakey-api-key default: claude-opus-4-8 models: - claude-opus-4-8 - gpt-5.5 - gemini-3.1-pro-preview - grok-4.5 ``` `provider: custom` demande à Hermes d'appeler directement votre endpoint. `models:` alimente le sélecteur `/model`; redémarrez Hermes après la modification, puis passez de `claude-opus-4-8` à `gpt-5.5`, `gemini-3.1-pro-preview` ou `grok-4.5` sans quitter la session. ## Une clé, quatre familles OmniaKey choisit le modèle par ID sur son endpoint compatible OpenAI. Un seul endpoint couvre les quatre familles, avec une facturation au token depuis un solde prépayé. L'ID configuré est celui qui s'exécute, sans fallback silencieux vers un modèle « équivalent ». Le [catalogue de modèles](https://omniakey.com/fr/models) liste tous les ids que vous pouvez définir, et [les tarifs](https://omniakey.com/fr/pricing) donnent le prix par token de chacun. La même clé fonctionne dans d'autres agents ; voir les guides [configurer OpenClaw](https://omniakey.com/fr/blog/openclaw-setup), [clé API personnalisée dans Cline](https://omniakey.com/fr/blog/cline-custom-api-key) et [configurer Claude Code](https://omniakey.com/fr/blog/claude-code-setup). - **OpenAI-compatible**: - **Anthropic-native**: - **Gemini-native**: ## Erreurs de configuration courantes Ces quatre cas reviennent souvent quand Hermes pointe vers un endpoint personnalisé. La cause et la solution viennent de la [documentation des fournisseurs de Hermes](https://hermes-agent.nousresearch.com/docs/integrations/providers) et de la [référence de configuration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration). ### `/model` ne propose pas l'endpoint personnalisé Symptôme : vous tapez `/model` dans une session ouverte et OmniaKey n'apparaît pas dans la liste. Cause : `/model` dans une session ne bascule qu'entre les fournisseurs déjà configurés. Il ne peut pas ajouter de fournisseur, lancer un OAuth ni demander une clé API. Solution : quittez la session, lancez `hermes model` dans le terminal, configurez l'endpoint personnalisé, puis démarrez une nouvelle session. ### Une clé dans `.env` est ignorée et les requêtes partent vers un autre fournisseur Symptôme : vous mettez la base URL ou la clé dans `~/.hermes/.env`, et Hermes appelle toujours un fournisseur intégré. Cause : `LLM_MODEL` dans `.env` a été supprimé, `config.yaml` est la seule source pour le modèle et l'endpoint, et `OPENAI_BASE_URL` ne compte que pour le fournisseur `openai-api`. Solution : mettez `base_url` et `api_key` dans le bloc `model:` de `~/.hermes/config.yaml`, ou pointez `key_env` vers la variable qui contient la clé. Une fois `base_url` défini, Hermes appelle cet endpoint directement et s'authentifie avec `api_key` ou `OPENAI_API_KEY`. ### Hermes ne démarre pas avec `provider: main` Symptôme : le démarrage échoue, ou le sélecteur de modèles reste vide, après avoir mis `provider: main` dans le bloc `model:` de premier niveau. Cause : `main` signifie « utilise le fournisseur de mon agent principal » et ne vaut que dans `auxiliary:`, `compression:` ou une entrée de repli. Solution : mettez `provider: custom` dans `model:`, à côté de la `base_url` et de la clé OmniaKey. ### `/model custom` choisit un autre modèle Symptôme : `/model custom` prend un modèle que vous n'avez pas demandé, ou renvoie une erreur. Cause : `/model custom` sans nom interroge l'API `/models` de l'endpoint et ne choisit automatiquement que si un seul modèle est chargé ; OmniaKey en sert plusieurs. Solution : nommez le modèle, par exemple `/model custom:claude-opus-4-8`. ## Questions fréquentes ### Comment connecter Hermes Agent à OmniaKey ? Lancez `hermes model`, choisissez Custom endpoint (self-hosted / VLLM / etc.) et saisissez `https://api.omniakey.com/v1` comme base URL, votre clé OmniaKey et un ID de modèle comme `claude-opus-4-8`. Les mêmes trois valeurs dans `~/.hermes/config.yaml` suffisent si vous préférez éditer le fichier. ### Pourquoi Hermes renvoie-t-il une erreur 404 avec ma base URL OmniaKey ? La base URL doit s'arrêter à `/v1`. Hermes ajoute `/chat/completions` lui-même, donc une URL qui contient déjà ce chemin, ou avec un slash final, est la cause habituelle du 404. ### Une seule clé OmniaKey suffit-elle pour Claude, GPT, Gemini et Grok ? Oui. OmniaKey choisit le modèle par ID sur son endpoint compatible OpenAI, donc un seul endpoint couvre les quatre familles : vous changez l'ID, pas le bloc de fournisseur. Ajoutez les ID voulus à la liste `models:` et ils apparaissent dans le sélecteur `/model`. ### Comment changer de modèle en cours de session ? Tapez `/model custom:`, par exemple `/model custom:gpt-5.5`. Redémarrez Hermes une fois après avoir modifié la liste `models:` : le sélecteur et `/model` voient alors les nouveaux ID. ## Sources vérifiées - [Nous Research : fournisseurs de LLM et de modèles](https://hermes-agent.nousresearch.com/docs/integrations/providers) - [Nous Research : configuration de Hermes Agent](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) Le [guide des agents de programmation](https://docs.omniakey.com/en/coding) couvre les autres outils.