APIMaster.ai
Documentation APIMaster.ai
Quick startAPIMaster.aiMarketplace

Hermes Desktop avec APIMaster.ai

Définissez la clé API et l'URL de base compatibles OpenAI dans Hermes Desktop sur Windows ou macOS, puis choisissez un modèle dans les Paramètres.

APIMaster.ai est compatible OpenAI. Hermes lit deux variables d'environnement, puis vous choisissez le modèle dans l'interface de bureau.

Configuration rapide

Étape 1 — Obtenez votre clé API

  1. Ouvrez la console APIMaster.
  2. Copiez votre clé API (commence généralement par sk-).
  3. Ne collez jamais une vraie clé dans un chat ou des captures d'écran ; utilisez le placeholder your_apimaster_key ci-dessous.

Étape 2 — Modifiez le fichier .env

Windows

  1. Appuyez sur Win + R, collez, puis appuyez sur Entrée :

    %LOCALAPPDATA%\hermes

  2. Ouvrez .env dans le Bloc-notes (créez le fichier s'il manque).

  3. Chemin complet typique :

    C:\Users\YourName\AppData\Local\hermes\.env

macOS

Hermes Desktop partage ~/.hermes avec la CLI (docs officielles). Placez les clés dans ~/.hermes/.env.

Option A — Finder (recommandé)

  1. Aller → Aller au dossier… (Shift + Commande + G).

  2. Collez :

    ~/.hermes

    (~ = votre dossier personnel ; .hermes est caché dans Finder sauf si vous utilisez Aller au dossier.)

  3. Ouvrez .env dans TextEdit (créez si manquant).

Option B — Terminal

open ~/.hermes

Chemin complet

/Users/YourName/.hermes/.env

Étape 3 — Ajoutez ces lignes

OPENAI_API_KEY=your_apimaster_key
OPENAI_BASE_URL=https://apimaster.ai/v1
  • OPENAI_BASE_URL doit se terminer par /v1 — pas https://apimaster.ai seul.
  • Pas d'espaces autour de =, pas de guillemets sauf si la documentation d'Hermes dit le contraire.
  • Enregistrez le fichier.

Étape 4 — Redémarrez Hermes Desktop

Quittez complètement Hermes (y compris l'icône dans la barre des tâches), puis ouvrez-le à nouveau.

Choisissez le modèle dans l'application

  1. Ouvrez Hermes Desktop.

  2. Allez dans Paramètres → Modèle → Modèle principal.

  3. Fournisseur : Point de terminaison personnalisé.

  4. Modèle : choisissez un identifiant de modèle pris en charge, par exemple :

    • claude-opus-4-8
    • claude-sonnet-4-6
    • gpt-5.5
    • gpt-5.4

    Consultez le marketplace ou votre administrateur pour la liste complète.

  5. Cliquez sur Appliquer, puis fermez les Paramètres.

Hermes Desktop : Paramètres → Modèle → Modèle principal

Test : choisissez un modèle et envoyez un message

1. Définissez le modèle principal dans les Paramètres (obligatoire)

  1. Ouvrez Paramètres (barre latérale ou en bas à gauche).
  2. Allez dans Modèle → Modèle principal.
  3. Fournisseur : Point de terminaison personnalisé (ou openai-api si affiché).
  4. Ouvrez la liste déroulante Modèle et cliquez sur un identifiant (ex. gpt-5.4) — ne tapez pas un nom d'affichage.
  5. Cliquez sur Appliquer et fermez les Paramètres.

Les nouveaux chats utilisent ce modèle après Appliquer ; les anciens chats peuvent encore utiliser le précédent.

2. Démarrez un nouveau chat

  1. Revenez à la liste des chats.
  2. Cliquez sur Nouveau chat (ou +).
  3. Utilisez une session fraîche, pas un ancien fil.

3. Vérifiez le modèle actif (recommandé)

Près de la saisie, vous pouvez voir quelque chose comme openai-api / gpt-5.4. Si c'est erroné, corrigez le modèle principal, Appliquez, et ouvrez un autre nouveau chat. Certaines versions offrent également une petite liste déroulante de modèles à côté du compositeur.

4. Envoyez un message de test

Tapez Hello, reply with ok et appuyez sur Entrée. Une réponse normale signifie que la clé, l'URL de base et le modèle fonctionnent.

5. Ça ne fonctionne toujours pas ?

Vérifiez le texte d'erreur (401, 404, timeout), confirmez qu'Hermes a été redémarré après avoir modifié .env, ou exécutez le test de connectivité API avec la même clé.

FAQ

Problème Que vérifier
L'envoi échoue L'URL est https://apimaster.ai/v1 ; clé copiée entièrement ; identifiant du modèle exact ; Hermes redémarré après modification de .env
Dossier manquant Utilisez ~/.hermes sur Mac (pas Application Support) ; lancez Hermes une fois ou mkdir -p ~/.hermes
Pas de Point de terminaison personnalisé Mettez à jour Hermes vers la dernière version
Mauvais modèles Les identifiants proviennent d'APIMaster ; voir Modèles pris en charge

Optionnel : test de connectivité API avec la même clé.

Sécurité

  • Ne partagez pas les clés API dans Slack, par e-mail ou dans des documents publics.
  • Utilisez des placeholders uniquement dans les tickets et les captures d'écran.
  • En cas de fuite, révoquez la clé dans la console, mettez à jour .env, et redémarrez Hermes.

Liste de vérification

  • Clé API copiée depuis la console (gardée privée)
  • OPENAI_API_KEY définie dans .env
  • OPENAI_BASE_URL=https://apimaster.ai/v1 (avec /v1)
  • .env enregistré
  • Hermes complètement redémarré
  • Fournisseur = Point de terminaison personnalisé, identifiant du modèle sélectionné, Appliquer cliqué
  • Le message de test fonctionne dans une nouvelle session

Voir aussi