Hermes Agent

Usa Hermes Agent con la sua opzione di endpoint personalizzato compatibile con OpenAI.

Hermes Agent di Nous Research

Cosa funziona

Hermes usa OneProvider tramite un provider personalizzato in modalità Chat Completions, con l'ID di un modello compatibile scelto dal catalogo.

Limite del client

Lascia la modalità API su Chat Completions; le altre modalità dei provider di Hermes non usano questa connessione compatibile con OpenAI.

Configurazione

1. Apri la configurazione dei modelli di Hermes

   Esegui la procedura guidata dei modelli e scegli Custom endpoint (self-hosted / VLLM / etc.).

   hermes model

2. Inserisci la connessione a OneProvider

   Usa https://api.oneprovider.dev/v1, la tua chiave OneProvider dedicata, l'ID di un modello compatibile scelto dal catalogo e Chat Completions come modalità API.

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

3. Oppure configura Hermes a mano

   Salva ONEPROVIDER_API_KEY=… in ~/.hermes/.env, poi imposta il blocco model in ~/.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

Verifica la connessione

Avvia una nuova sessione di Hermes

Fai una domanda breve, poi controlla nella Dashboard di OneProvider l'ID del modello configurato, il consumo di token e l'importo addebitato.

Dati di connessione

Protocollo

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Sicurezza della chiave

Usa una chiave di inferenza dedicata, limitata al modello necessario, con controlli su frequenza, spesa e scadenza. Tieni la chiave in ~/.hermes/.env anziché in config.yaml.

Quale modello scegliere

Imposta default nel blocco model di config.yaml. gpt-6.1-terra è una buona scelta di tutti i giorni, gpt-6.1-sol è il livello di punta per compiti difficili, gpt-5.6-luna è economico per lavori rapidi o ad alto volume. Usa Chat Completions come modalità API e copia gli ID dalla pagina dei modelli .

Errori comuni e soluzioni

401

La chiave non viene letta: verifica che ONEPROVIDER_API_KEY=… sia in ~/.hermes/.env e che key_env in config.yaml indichi la stessa variabile.

404

base_url deve essere https://api.oneprovider.dev/v1 con /v1.

«Model not found»

L'ID non è nel catalogo o ha un errore di battitura. Copialo dalla pagina dei modelli.

429 «Insufficient balance»

Il saldo o il limite della chiave è esaurito. Ricarica l'area personale.

La procedura guidata non elenca OneProvider

Scegli Custom endpoint in hermes model: OneProvider si aggiunge come endpoint personalizzato compatibile con OpenAI.

FAQ

Dove tengo la chiave?

In ~/.hermes/.env, non in config.yaml.

Posso usare i modelli Claude?

Sì, inserisci un ID Claude come claude-sonnet-5-5 nello stesso endpoint personalizzato; le capacità dipendono dal modello.

Come verifico che funzioni?

Avvia una nuova sessione, fai una domanda breve e cerca la richiesta in «Consumo» nella Dashboard.

Risposte rapide

Quale base URL devo usare?

Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Come mi autentico?

Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .

Dove ottengo una chiave?

Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .

Cosa significano 401, 404 e 429?

401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .

Perché gli stream si interrompono o si resettano?

VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.

Dove chiedo se non basta?

Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .