Seedream 5.0 Pro è LIVE | Prova nel Generatore di immagini →
Accedi
DashboardEsploraGeneratore AIHotApp DesktopChiavi APIFatturazione
Setup agent

Connetti Hermes alla WaveSpeed LLM API

Copia il setup ~/.hermes/config.yaml consigliato per Hermes, instrada le richieste a /v1/chat/completions e verifica le chiamate agent locali in WaveSpeed Logs.

API keyTesta modello
File di configurazione

~/.hermes/config.yaml

Protocollo

Chat completions compatibili con OpenAI

Endpoint

/v1/chat/completions

Avvio rapido

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in~/.hermes/config.yaml

4

Esegui hermes chat e controlla Logs

Chat completions compatibili con OpenAI

L’utilizzo appare in Dashboard e Logs

Cambia modello senza riscrivere il codice dell’agent

Modifica ~/.hermes/config.yaml
# File: ~/.hermes/config.yaml
model:
  default: "anthropic/claude-opus-4.8"
  provider: wavespeed
custom_providers:
  - name: wavespeed
    base_url: https://llm.wavespeed.ai/v1
    key_env: WAVESPEED_API_KEY
    api_mode: chat_completions

Non sostituire il nome della variabile

WAVESPEED_API_KEY è il nome della variabile d’ambiente letta dall’agent. Mantieni questo nome nel file di configurazione e inserisci la vera API key nella shell.

1

Temporaneo per questo terminale

Funziona finché non chiudi questa finestra del terminale.

export WAVESPEED_API_KEY="wsk-..."
2

Mantieni dopo il riavvio

Scrive la key nel profilo shell così i nuovi terminali possono leggerla.

echo 'export WAVESPEED_API_KEY="wsk-..."' >> ~/.zshrc
source ~/.zshrc

Guida integrazione agent

Usa Hermes con la WaveSpeed LLM API

Questa guida mostra come collegare Hermes a WaveSpeed AI con ~/.hermes/config.yaml, Chat completions compatibili con OpenAI, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1 e modello predefinito anthropic/claude-opus-4.8. Copia la configurazione sopra, esporta la tua API key, avvia l’agent e verifica le richieste in Logs.

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in

~/.hermes/config.yaml
4

Esegui hermes chat e controlla Logs

Cosa configura questo setup di Hermes

Protocollo

Chat completions compatibili con OpenAI

Endpoint

/v1/chat/completions

Modello

anthropic/claude-opus-4.8

La configurazione pronta da copiare sopra è l’unico file Hermes da modificare per il setup consigliato: ~/.hermes/config.yaml. Mantieni la API key nell’ambiente shell per non committarla in un repository.

Risoluzione problemi

La API key non viene letta

Esporta WAVESPEED_API_KEY nella stessa shell in cui esegui Hermes. Se usi un profilo shell, ricarica il terminale prima di avviare l’agent.

Le richieste falliscono con errore di protocollo o endpoint

Controlla che Hermes usi Chat completions compatibili con OpenAI ed endpoint /v1/chat/completions. Le discrepanze di protocollo sono la causa più comune di errori 404 o payload.

Il modello selezionato non funziona

Conferma che l’ID modello esista in WaveSpeed Models, poi incolla l’ID esatto in ~/.hermes/config.yaml. Puoi iniziare dal modello predefinito mostrato in questa pagina.

In Logs non appare alcuna richiesta

Assicurati che Hermes usi la base URL WaveSpeed e la tua API key attuale. Poi invia un nuovo prompt dall’agent locale e aggiorna Logs.

Questa guida Hermes può apparire nei motori di ricerca?

Sì. Questa pagina è costruita come guida di setup indicizzabile per utenti che cercano Hermes custom provider, endpoint compatibile OpenAI, base URL e workflow di configurazione agent locale.

Vedi tutte le guide di setup agentSfoglia modelli
Usa Hermes con la WaveSpeed LLM API