---
title: Comment ajouter un fournisseur personnalisé à Hermes Agent (2026)
description: >-
  Connectez Hermes Agent à n'importe quel fournisseur compatible avec l'API
  OpenAI — MiniMax, DeepSeek, Gemini, Grok, OpenAI ou haimaker.ai. URLs de base,
  clés API et résolution des timeouts.
date: 2026-05-11T00:00:00.000Z
updatedDate: 2026-06-26T00:00:00.000Z
location: 'San Francisco, Californie – 11 mai 2026'
image: /images/hermes-custom-provider-setup-hero.jpg
keywords: >-
  hermes agent fournisseur personnalisé, configuration fournisseur hermes agent,
  clé API hermes agent, configuration fournisseur minimax hermes agent, api
  gemini hermes agent, configuration deepseek hermes agent, api grok hermes
  agent, endpoint personnalisé hermes, API compatible OpenAI hermes agent
faq:
  - question: Comment ajouter un fournisseur personnalisé à Hermes Agent ?
    answer: >-
      Exécutez `hermes model` dans votre terminal, choisissez « Custom endpoint
      », puis saisissez trois éléments : l'URL de base du fournisseur (se
      terminant par /v1), votre clé API et l'identifiant du modèle. Hermes
      enregistre la sélection et l'utilise à chaque exécution. Tout fournisseur
      exposant un endpoint /v1/chat/completions compatible avec l'API OpenAI
      fonctionne — MiniMax, DeepSeek, Google, xAI, OpenAI, OpenRouter, une
      instance Ollama locale ou haimaker.ai. Pour haimaker.ai, la commande 'npx
      -y @haimaker/connect --hermes' configure Hermes en une seule commande.
  - question: De quelle URL de base Hermes Agent a-t-il besoin ?
    answer: >-
      Hermes a besoin de la racine compatible OpenAI, pas du chemin complet
      /chat/completions. Utilisez https://api.haimaker.ai/v1 pour haimaker,
      https://api.minimax.io/v1 pour MiniMax, https://api.deepseek.com/v1 pour
      DeepSeek, https://generativelanguage.googleapis.com/v1beta/openai pour la
      couche compatible OpenAI de Gemini, https://api.x.ai/v1 pour xAI Grok,
      https://api.openai.com/v1 pour OpenAI, ou http://localhost:11434/v1 pour
      Ollama. Hermes ajoute /chat/completions lui-même.
  - question: Pourquoi mon fournisseur personnalisé Hermes provoque-t-il des timeouts ?
    answer: >-
      Les longues étapes de l'agent sur un fournisseur plus lent peuvent
      dépasser le timeout de lecture par défaut de Hermes. Définissez la
      variable d'environnement HERMES_STREAM_READ_TIMEOUT (en secondes) à une
      valeur plus élevée avant de lancer Hermes, et vérifiez que votre URL de
      base se termine par /v1 sans barre oblique finale. Un code 401 au lieu
      d'un timeout signifie que la clé API n'a pas été prise en compte —
      relancez `hermes model` et ressaisissez-la.
locale: fr-fr
translationKey: hermes-custom-provider-setup
---
Hermes Agent est livré avec une courte liste de fournisseurs intégrés, mais sa véritable flexibilité réside dans l'option **Custom endpoint** : tout service qui implémente le format chat-completions d'OpenAI se connecte avec une URL de base, une clé et un nom de modèle. Cela couvre MiniMax, DeepSeek, Google Gemini, xAI Grok, OpenAI, OpenRouter, un serveur vLLM privé, une instance Ollama locale et [haimaker.ai](https://haimaker.ai), qui regroupe tous ces fournisseurs en un seul.

Voici la configuration générale, puis les valeurs exactes pour les fournisseurs qui suscitent le plus de questions.

## La méthode générale

Chaque fournisseur personnalisé dans Hermes se configure avec la même procédure :

```bash
hermes model
```

1. Choisissez **Custom endpoint** dans le menu.
2. Saisissez l'**URL de base** — la racine compatible OpenAI, se terminant par `/v1` (Hermes ajoute `/chat/completions` lui-même).
3. Saisissez votre **clé API** pour ce fournisseur.
4. Saisissez l'**identifiant du modèle** attendu par le fournisseur.

Hermes enregistre la sélection et l'utilise pour chaque exécution ultérieure. Pour changer de fournisseur, relancez simplement `hermes model`. Le mécanisme se résume à cela — la suite de cet article détaille les valeurs à utiliser.

Un modèle ne fonctionne bien dans Hermes que s'il respecte les schémas d'outils et dispose d'assez de contexte pour les boucles de l'agent — visez au moins ~64K de contexte utilisable. Consultez [Meilleurs modèles pour Hermes Agent](/blog/best-models-for-hermes/) pour savoir quel modèle choisir.

## haimaker.ai — une seule clé pour tous les modèles

Au lieu de gérer un compte, une clé et une URL de base distincts par fournisseur, pointez Hermes vers haimaker.ai une seule fois et changez de modèle en modifiant une seule chaîne. La méthode la plus rapide se résume à une seule commande :

```bash
export HAIMAKER_API_KEY=your-haimaker-key
npx -y @haimaker/connect --hermes
```

[`@haimaker/connect`](/connect) écrit la configuration de l'endpoint personnalisé dans Hermes, vérifie la clé, puis se termine. Ajoutez `--model` pour fixer un modèle ou `--pick-model` pour en choisir un de manière interactive, et exécutez `npx @haimaker/connect --uninstall --hermes` pour annuler la configuration. Commencez par créer une clé sur [app.haimaker.ai](https://app.haimaker.ai/sign-up) ; les nouveaux comptes bénéficient de crédits gratuits.

Vous préférez utiliser la commande intégrée `hermes model` ? Saisissez ces valeurs lorsqu'elle vous le demande :

- **URL de base :** `https://api.haimaker.ai/v1`
- **Clé API :** votre clé haimaker.ai
- **Modèle :** n'importe quel modèle pris en charge, par ex. `anthropic/claude-sonnet-4-6`, `openai/gpt-5-4-codex`, `google/gemini-3-1-pro`, `minimax/minimax-m2-5`, `deepseek/deepseek-v3-2`, `xai/grok-4-1-fast`, `zai/glm-4-7`, `moonshot/kimi-k2-5`

Les modèles coûtent environ 5 % de moins que le tarif du marché, et vous ne gérez qu'un seul compte de facturation.

## MiniMax dans Hermes

MiniMax M2.5 est le choix économique le plus populaire pour Hermes — suffisamment abordable pour tourner en continu, suffisamment robuste pour gérer les boucles d'outils.

- **URL de base :** `https://api.minimax.io/v1`
- **Clé API :** depuis la console de votre plateforme MiniMax
- **Modèle :** `MiniMax-M2.5` (utilisez l'ID exact affiché dans la console MiniMax — la casse compte)

Ou passez par haimaker.ai avec le modèle `minimax/minimax-m2-5` pour éviter de créer un compte séparé.

## Google Gemini dans Hermes

Gemini expose une couche compatible OpenAI, ce qui permet de l'utiliser comme endpoint personnalisé dans Hermes.

- **URL de base :** `https://generativelanguage.googleapis.com/v1beta/openai`
- **Clé API :** votre clé Google AI Studio
- **Modèle :** `gemini-3-flash` pour un travail rapide et économique ; `gemini-3.1-pro` pour la recherche sur de longs contextes

Oui, Hermes Agent prend en charge Google Gemini de cette façon — il n'y a pas d'intégration Gemini séparée à activer, c'est simplement un endpoint personnalisé. Vous pouvez aussi utiliser `google/gemini-3-1-pro` via haimaker.ai.

## DeepSeek dans Hermes

- **URL de base :** `https://api.deepseek.com/v1`
- **Clé API :** depuis la plateforme DeepSeek
- **Modèle :** `deepseek-chat` (correspond à la gamme V3.2 actuelle) ou `deepseek-reasoner`

Via haimaker.ai : `deepseek/deepseek-v3-2`.

## xAI Grok dans Hermes

- **URL de base :** `https://api.x.ai/v1`
- **Clé API :** depuis la console xAI
- **Modèle :** `grok-4.1-fast` pour des tâches à grand contexte à moindre coût, `grok-code-fast` pour les tâches spécifiques au code

Via haimaker.ai : `xai/grok-4-1-fast`.

## Modèles OpenAI / Codex dans Hermes

Si vous souhaitez utiliser les modèles d'OpenAI (y compris la gamme Codex) avec Hermes :

- **URL de base :** `https://api.openai.com/v1`
- **Clé API :** une clé **API** OpenAI (un abonnement ChatGPT Plus ne donne pas accès à l'API — il vous faut une clé API distincte avec la facturation activée)
- **Modèle :** `gpt-5.4-codex` pour le code, `gpt-5.4` pour un usage général

Via haimaker.ai : `openai/gpt-5-4-codex`.

## Modèles locaux via Ollama

- **URL de base :** `http://localhost:11434/v1`
- **Clé API :** n'importe quelle chaîne non vide (Ollama l'ignore, mais Hermes exige une valeur)
- **Modèle :** `gemma4:latest`, `qwen3.5:latest`, ou tout modèle que vous avez téléchargé

```bash
ollama pull gemma4
hermes model   # Custom endpoint → base URL above → model gemma4:latest
```

## Problèmes courants

- **Timeouts sur les étapes longues.** Les fournisseurs plus lents peuvent dépasser le timeout de lecture par défaut de Hermes lors des étapes lourdes de l'agent. Définissez `HERMES_STREAM_READ_TIMEOUT` (en secondes) à une valeur plus élevée avant de lancer Hermes.
- **Erreurs 401 / authentification.** La clé n'a pas été enregistrée, ou vous avez collé un token de console ou de session au lieu d'une clé API. Relancez `hermes model` et ressaisissez-la.
- **404 sur les requêtes.** Votre URL de base inclut probablement déjà `/chat/completions`, ou comporte une barre oblique finale. Hermes ajoute le chemin lui-même — l'URL doit se terminer par `/v1`.
- **Appels d'outils qui échouent de manière répétée.** C'est généralement le modèle en cause, pas la configuration. Les petits modèles ne respectent pas toujours les schémas d'outils ; passez à un modèle plus performant.

## Obtenez votre clé haimaker.ai

Les nouveaux comptes reçoivent des crédits gratuits pour tester. Parcourez tous les modèles pris en charge avec les tarifs en temps réel et les benchmarks sur [haimaker.ai](https://haimaker.ai), puis exécutez `npx -y @haimaker/connect --hermes` pour y connecter Hermes.

<a href="https://app.haimaker.ai/sign-up?utm_source=hermes_blog&utm_medium=cta&utm_campaign=hermes_custom_provider" class="cta-button">OBTENEZ 10 $ DE CRÉDITS GRATUITS SUR HAIMAKER</a>

---

*Articles connexes : [Meilleurs modèles pour Hermes Agent](/blog/best-models-for-hermes/) · [Tarifs de Hermes Agent](/blog/hermes-api-costs-pricing/) · [Hermes Agent vs Codex CLI](/blog/hermes-vs-codex/)*