Proxy d'Abonnement — Passerelle Partagée

Considérez cela comme un abonnement de salle de sport : vous ne donneriez pas votre vraie carte à votre ami au risque de la perdre. À la place, vous lui offririez un pass invité. Le Proxy d’Abonnement, c’est exactement ce pass invité pour vos abonnements IA.

Le Problème Qu’Il Résout

De nombreuses applications d’IA — comme OpenViking ou Open WebUI — parlent le format d’API OpenAI. Vous pourriez leur donner directement votre clé d’abonnement Nous Portal, mais c’est risqué (elles pourraient la fuiter) et pénible (les clés expirent). Le proxy corrige cela en exécutant un petit serveur local. Chaque requête de votre application passe par lui, et le proxy attache automatiquement vos vraies identifiants. Vos applications peuvent utiliser n’importe quelle fausse clé — le proxy échange la vraie en arrière-plan.

En Quoi Cela Diffère du Serveur API

	Serveur API	Proxy d’Abonnement
Ce qu’il fournit	Agents Hermes complets (outils, mémoire, compétences)	Inférence de modèle pure
Idéal pour	« Utiliser Hermes comme backend de chat »	« Partager votre abonnement Portal avec d’autres applications »
Authentification	Nécessite votre API_SERVER_KEY	N’importe quel jeton bearer (le proxy le remplace)
Appel d’outils	Pris en charge	Non pris en charge (simple passage)

En une phrase : Utilisez le serveur API quand vous voulez un agent ; utilisez le proxy quand vous voulez juste le modèle.

Trois Étapes Pour Commencer

1. Connectez-Vous Une Fois

hermes portal

Un navigateur s’ouvre avec la page d’autorisation Nous Portal. Après votre connexion, Hermes stocke le jeton de rafraîchissement dans ~/.hermes/auth.json.

2. Démarrez le Proxy

hermes proxy start

Vous verrez une sortie comme :

Starting Hermes proxy for Nous Portal
  Listening on:  http://127.0.0.1:8645/v1
  Forwarding to: (resolved per-request from your subscription)
  Use any bearer token in the client — the proxy attaches your real credential.

Vous voulez qu’il tourne en arrière-plan ? Utilisez tmux, nohup, ou un service systemd.

3. Configurez Votre Application

Toute application compatible OpenAI n’a besoin que de trois réglages :

Base URL :   http://127.0.0.1:8645/v1
Clé API :    n’importe quoi (par ex. "sk-unused")
Modèle :     Hermes-4-70B    # ou Hermes-4.3-36B, Hermes-4-405B

Le proxy ignore la clé que vous tapez et la remplace par votre véritable identifiant Portal — et la rafraîchit automatiquement avant expiration.

Vérifier le Statut

hermes proxy status

Vous voulez voir ready. Si cela indique not logged in, relancez hermes portal. Si cela indique credentials need attention, votre jeton de rafraîchissement a été révoqué (généralement parce que vous vous êtes déconnecté sur le site Portal) — reconnectez-vous simplement.

Points d’Accès Pris en Charge

Le proxy ne transmet que les chemins que l’amont prend réellement en charge ; tout le reste renvoie une 404 avec un message clair :

Chemin	Objectif
/v1/chat/completions	Complétions de chat (streaming pris en charge)
/v1/completions	Complétions de texte héritées
/v1/embeddings	Vecteurs d’intégration
/v1/models	Liste des modèles disponibles

Résumé & Conseils Pratiques

Le proxy d’abonnement est un adaptateur sûr : il permet à d’autres applications de partager votre abonnement sans jamais exposer votre vraie clé, et il gère l’expiration pour vous. Actuellement, il prend en charge Nous Portal et xAI (Grok), avec d’autres fournisseurs à venir.

Un conseil pratique : Si vous utilisez plusieurs applications, donnez à chacune une fausse clé différente (comme sk-app1, sk-app2). Ainsi, les journaux du proxy montrent exactement quelle application fait quelles requêtes — ce qui rend le débogage bien plus facile. De plus, le proxy n’écoute que sur 127.0.0.1 par défaut. Ne le changez pas en 0.0.0.0, sinon tout appareil de votre réseau pourrait aussi utiliser votre abonnement.