OneProvider

Hermes Agent

Connectez Hermes Agent (Nous Research) à OneProvider comme fournisseur compatible OpenAI (Chat Completions). Configuration et test d’une première session.

Exécutez Hermes Agent via son option d’endpoint personnalisé compatible OpenAI.

Tous les modèles, leurs capacités et leurs tarifs Index de la documentation pour les agents IA : https://oneprovider.dev/docs/llms.txt

Hermes Agent de Nous Research

Documentation officielle

Ce qui fonctionne

Hermes utilise OneProvider via un fournisseur personnalisé en mode Chat Completions, avec un ID de modèle compatible que vous choisissez dans le catalogue.

Limite du client

Laissez API mode sur Chat Completions ; les autres modes de fournisseur de Hermes n’utilisent pas cette connexion compatible OpenAI.

Avant de commencer : une clé de votre espace client Ouvrez votre espace client : le bot Telegram @oneprovider_robot (« Mon espace ») ou app.oneprovider.dev . Appuyez sur « Créer une clé », donnez-lui un nom (par exemple, ce client) et une limite de dépense, puis copiez la clé. Vous rechargez le solde au même endroit. En savoir plus sur l’espace client et les clés .

Configuration

  1. Ouvrir la configuration du modèle de Hermes

    Lancez l’assistant de modèle et choisissez Custom endpoint (self-hosted / VLLM / etc.).

    hermes model

  2. Saisir la connexion OneProvider

    Utilisez https://api.oneprovider.dev/v1, votre clé OneProvider dédiée, un ID de modèle compatible choisi dans le catalogue, et Chat Completions comme mode d’API.

    Endpoint: https://api.oneprovider.dev/v1
API key: sk-your-key-here
Model: gpt-6.1-terra
Mode: Chat Completions

  3. Ou configurer Hermes manuellement

    Enregistrez ONEPROVIDER_API_KEY=… dans ~/.hermes/.env, puis définissez le bloc model dans ~/.hermes/config.yaml.

    # ~/.hermes/.env
ONEPROVIDER_API_KEY=sk-your-key-here
# ~/.hermes/config.yaml
model:
default: gpt-6.1-terra
provider: custom
base_url: https://api.oneprovider.dev/v1
key_env: ONEPROVIDER_API_KEY

Vérifier la connexion

Démarrer une nouvelle session Hermes

Posez une question courte, puis confirmez dans le Dashboard OneProvider l’ID du modèle configuré, la consommation de jetons et le montant débité.

Paramètres de connexion

Protocole
openai-chat
Endpoint
https://api.oneprovider.dev/v1

Sécurité de la clé

Utilisez une clé d’inférence dédiée, limitée au modèle nécessaire, avec des contrôles de débit, de dépense et d’expiration. Gardez la clé dans ~/.hermes/.env plutôt que dans config.yaml.

Quel modèle choisir

Définissez default dans le bloc model de config.yaml. gpt-6.1-terra est un bon choix quotidien par défaut, gpt-6.1-sol est le niveau frontière pour les tâches difficiles, gpt-5.6-luna est économique pour le travail rapide ou à gros volume. Utilisez Chat Completions comme mode d’API et copiez les ID depuis la page des modèles .

Erreurs courantes et solutions

401

La clé n’est pas lue : vérifiez que ONEPROVIDER_API_KEY=… figure dans ~/.hermes/.env et que key_env dans config.yaml désigne la même variable.

404

base_url doit être https://api.oneprovider.dev/v1 avec /v1.

« Model not found »

L’ID n’est pas dans le catalogue ou contient une faute de frappe. Copiez-le depuis la page des modèles.

429 « Insufficient balance »

Le solde est épuisé ou la limite de la clé est atteinte. Rechargez le solde de l’espace client.

L’assistant ne propose pas OneProvider

Choisissez Custom endpoint dans hermes model : OneProvider est ajouté comme endpoint personnalisé compatible OpenAI.

FAQ

Où garder la clé ?

Dans ~/.hermes/.env, pas dans config.yaml.

Puis-je utiliser des modèles Claude ?

Oui, saisissez un ID Claude comme claude-sonnet-5-5 dans le même endpoint personnalisé ; les capacités dépendent du modèle.

Comment vérifier que cela fonctionne ?

Démarrez une nouvelle session, posez une question courte et cherchez la requête sur la page « Consommation » du Dashboard.

Réponses rapides

Quelle base URL utiliser ?

Claude Code et les SDK Anthropic utilisent https://api.oneprovider.dev. Les SDK OpenAI et les clients compatibles OpenAI utilisent https://api.oneprovider.dev/v1. Une seule clé fonctionne avec les deux ; la liste des modèles est sur la page des modèles , les tarifs sur la page des tarifs .

Comment s’authentifier ?

Envoyez la clé sk-… telle quelle dans x-api-key ou Authorization: Bearer : l’un des deux, jamais les deux. Conservez la clé dans une variable d’environnement, pas dans un fichier qui sera commité. En savoir plus sur l’authentification .

Où obtenir une clé ?

Ouvrez votre espace client dans le bot Telegram @oneprovider_robot ou sur app.oneprovider.dev, rechargez le solde et appuyez sur « Créer une clé ». Chaque clé peut avoir sa propre limite de dépense. Espace client et clés API .

Que signifient 401, 404 et 429 ?

401 : la clé est absente, mal saisie ou envoyée dans le mauvais en-tête ; collez la clé entière, sans guillemets ni espaces. 404 : le plus souvent une base URL incorrecte, par exemple un /v1 manquant ou en double. 429 avec « Insufficient balance » : le solde de l’espace client est à zéro ou la clé a atteint sa limite de dépense, donc rechargez au lieu de réessayer ; tout autre 429 est une limite de débit, donc attendez le délai indiqué par Retry-After. Détails : codes d’erreur et dépannage .

Pourquoi les flux se coupent-ils ou se réinitialisent-ils ?

Les VPN et les proxys VLESS mettent souvent le SSE en mémoire tampon ou perturbent la négociation HTTP/2. OneProvider n’a aucune restriction régionale et ne met pas les flux en mémoire tampon : désactivez le proxy et réessayez.

Où demander de l’aide si cela ne suffit pas ?

Écrivez à @Oneproviderhelpbot sur Telegram ou ouvrez « Support » dans l’espace client web, en indiquant le code de statut HTTP et le message d’erreur exact. Comment fonctionne le support .

Dernière mise à jour: 2026-11-08 Vous avez trouvé un bug ? @Oneproviderhelpbot