APIMaster.ai
Documentazione APIMaster.ai
Quick startAPIMaster.aiMarketplace

Hermes Desktop con APIMaster.ai

Imposta la chiave API e l'URL di base compatibili con OpenAI in Hermes Desktop su Windows o macOS, poi scegli un modello in Impostazioni.

APIMaster.ai è compatibile con OpenAI. Hermes legge due variabili d'ambiente, poi scegli il modello nell'interfaccia desktop.

Configurazione rapida

Passo 1 — Ottieni la tua chiave API

  1. Apri la console APIMaster.
  2. Copia la tua chiave API (di solito inizia con sk-).
  3. Non incollare mai una chiave reale in chat o screenshot; usa il segnaposto your_apimaster_key qui sotto.

Passo 2 — Modifica il file .env

Windows

  1. Premi Win + R, incolla e premi Invio:

    %LOCALAPPDATA%\hermes

  2. Apri .env nel Blocco note (crea il file se mancante).

  3. Percorso completo tipico:

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

macOS

Hermes Desktop condivide ~/.hermes con la CLI (documentazione ufficiale). Inserisci le chiavi in ~/.hermes/.env.

Opzione A — Finder (consigliato)

  1. Vai → Vai alla cartella… (Shift + Command + G).

  2. Incolla:

    ~/.hermes

    (~ = la tua cartella home; .hermes è nascosto in Finder a meno che non usi Vai alla cartella.)

  3. Apri .env in TextEdit (crea se mancante).

Opzione B — Terminale

open ~/.hermes

Percorso completo

/Users/YourName/.hermes/.env

Passo 3 — Aggiungi queste righe

OPENAI_API_KEY=your_apimaster_key
OPENAI_BASE_URL=https://apimaster.ai/v1
  • OPENAI_BASE_URL deve terminare con /v1 — non solo https://apimaster.ai.
  • Nessuno spazio intorno a =, niente virgolette a meno che la documentazione di Hermes non dica diversamente.
  • Salva il file.

Passo 4 — Riavvia Hermes Desktop

Esci completamente da Hermes (inclusa l'icona della barra delle applicazioni), poi riaprilo.

Scegli il modello nell'app

  1. Apri Hermes Desktop.

  2. Vai su Impostazioni → Modello → Modello principale.

  3. Provider: Endpoint personalizzato.

  4. Modello: scegli un ID modello supportato, ad esempio:

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

    Consulta il marketplace o il tuo amministratore per l'elenco completo.

  5. Fai clic su Applica, poi chiudi Impostazioni.

Hermes Desktop: Impostazioni → Modello → Modello principale

Test: scegli un modello e invia un messaggio

1. Imposta il modello principale in Impostazioni (obbligatorio)

  1. Apri Impostazioni (barra laterale o in basso a sinistra).
  2. Vai su Modello → Modello principale.
  3. Provider: Endpoint personalizzato (o openai-api se mostrato).
  4. Apri il menu a discesa Modello e fai clic su un ID (es. gpt-5.4) — non digitare un nome visualizzato.
  5. Fai clic su Applica e chiudi Impostazioni.

Le nuove chat utilizzano questo modello dopo Applica; le chat vecchie potrebbero ancora usare quello precedente.

2. Avvia una nuova chat

  1. Torna all'elenco delle chat.
  2. Fai clic su Nuova chat (o +).
  3. Usa una sessione nuova, non un thread vecchio.

3. Controlla il modello attivo (consigliato)

Vicino all'input potresti vedere qualcosa come openai-api / gpt-5.4. Se è sbagliato, correggi il Modello principale, Applica e apri un'altra chat nuova. Alcune versioni offrono anche un piccolo menu a discesa del modello accanto al compositore.

4. Invia un messaggio di prova

Digita Hello, reply with ok e premi Invio. Una risposta normale significa che chiave, URL di base e modello funzionano.

5. Ancora non funziona?

Controlla il testo dell'errore (401, 404, timeout), conferma che Hermes sia stato riavviato dopo la modifica di .env, o esegui il test di connettività API con la stessa chiave.

FAQ

Problema Cosa controllare
Invio fallisce L'URL è https://apimaster.ai/v1; chiave copiata completamente; ID modello esatto; Hermes riavviato dopo la modifica di .env
Cartella mancante Usa ~/.hermes su Mac (non Application Support); avvia Hermes una volta o mkdir -p ~/.hermes
Nessun Endpoint personalizzato Aggiorna Hermes all'ultima versione
Modelli sbagliati Gli ID provengono da APIMaster; vedi Modelli supportati

Opzionale: test di connettività API con la stessa chiave.

Sicurezza

  • Non condividere le chiavi API in Slack, email o documenti pubblici.
  • Usa solo segnaposto nei ticket e negli screenshot.
  • Se divulgata, revoca la chiave nella console, aggiorna .env e riavvia Hermes.

Lista di controllo

  • Chiave API copiata dalla console (tenuta privata)
  • OPENAI_API_KEY impostata in .env
  • OPENAI_BASE_URL=https://apimaster.ai/v1 (con /v1)
  • .env salvato
  • Hermes riavviato completamente
  • Provider = Endpoint personalizzato, ID modello selezionato, Applica cliccato
  • Messaggio di test funziona in una sessione nuova

Vedi anche