APIMaster.ai
APIMaster.ai Dokumentation
Quick startAPIMaster.aiMarketplace

Hermes Desktop mit APIMaster.ai

Legen Sie den OpenAI-kompatiblen API-Schlüssel und die Basis-URL in Hermes Desktop unter Windows oder macOS fest und wählen Sie dann ein Modell in den Einstellungen.

APIMaster.ai ist OpenAI-kompatibel. Hermes liest zwei Umgebungsvariablen, dann wählen Sie das Modell in der Desktop-Oberfläche aus.

Schnelleinrichtung

Schritt 1 – API-Schlüssel abrufen

  1. Öffnen Sie die APIMaster-Konsole.
  2. Kopieren Sie Ihren API-Schlüssel (beginnt normalerweise mit sk-).
  3. Fügen Sie niemals einen echten Schlüssel in Chats oder Screenshots ein; verwenden Sie unten den Platzhalter your_apimaster_key.

Schritt 2 – Die .env-Datei bearbeiten

Windows

  1. Drücken Sie Win + R, fügen Sie Folgendes ein und drücken Sie die Eingabetaste:

    %LOCALAPPDATA%\hermes

  2. Öffnen Sie .env im Editor (erstellen Sie die Datei, falls sie fehlt).

  3. Typischer vollständiger Pfad:

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

macOS

Hermes Desktop teilt sich ~/.hermes mit der CLI (offizielle Dokumentation). Fügen Sie die Schlüssel in ~/.hermes/.env ein.

Option A – Finder (empfohlen)

  1. Gehe zu → Gehe zum Ordner… (Umschalt + Befehl + G).

  2. Fügen Sie Folgendes ein:

    ~/.hermes

    (~ = Ihr Benutzerordner; .hermes ist im Finder versteckt, es sei denn, Sie verwenden „Gehe zum Ordner“.)

  3. Öffnen Sie .env in TextEdit (erstellen Sie die Datei, falls sie fehlt).

Option B – Terminal

open ~/.hermes

Vollständiger Pfad

/Users/IhrName/.hermes/.env

Schritt 3 – Diese Zeilen hinzufügen

OPENAI_API_KEY=your_apimaster_key
OPENAI_BASE_URL=https://apimaster.ai/v1
  • OPENAI_BASE_URL muss mit /v1 enden – nicht nur https://apimaster.ai.
  • Keine Leerzeichen um =, keine Anführungszeichen, sofern die Hermes-Dokumentation nichts anderes sagt.
  • Speichern Sie die Datei.

Schritt 4 – Hermes Desktop neu starten

Beenden Sie Hermes vollständig (einschließlich des Taskleistensymbols) und öffnen Sie es dann erneut.

Modell in der App auswählen

  1. Öffnen Sie Hermes Desktop.

  2. Gehen Sie zu Einstellungen → Modell → Hauptmodell.

  3. Anbieter: Benutzerdefinierter Endpunkt.

  4. Modell: Wählen Sie eine unterstützte Modell-ID, zum Beispiel:

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

    Die vollständige Liste finden Sie im Marktplatz oder bei Ihrem Administrator.

  5. Klicken Sie auf Übernehmen und schließen Sie die Einstellungen.

Hermes Desktop: Einstellungen → Modell → Hauptmodell

Test: Modell auswählen und eine Nachricht senden

1. Hauptmodell in den Einstellungen festlegen (erforderlich)

  1. Öffnen Sie Einstellungen (Seitenleiste oder unten links).
  2. Gehen Sie zu Modell → Hauptmodell.
  3. Anbieter: Benutzerdefinierter Endpunkt (oder openai-api, falls angezeigt).
  4. Öffnen Sie das Dropdown Modell und klicken Sie auf eine ID (z. B. gpt-5.4) – geben Sie keinen Anzeigenamen ein.
  5. Klicken Sie auf Übernehmen und schließen Sie die Einstellungen.

Neue Chats verwenden dieses Modell nach dem Übernehmen; alte Chats verwenden möglicherweise weiterhin das vorherige.

2. Neuen Chat starten

  1. Kehren Sie zur Chat-Liste zurück.
  2. Klicken Sie auf Neuer Chat (oder +).
  3. Verwenden Sie eine neue Sitzung, keinen alten Thread.

3. Aktives Modell überprüfen (empfohlen)

In der Nähe des Eingabefelds sehen Sie möglicherweise etwas wie openai-api / gpt-5.4. Wenn es falsch ist, korrigieren Sie das Hauptmodell, klicken Sie auf Übernehmen und öffnen Sie einen weiteren neuen Chat. Einige Builds bieten auch ein kleines Modell-Dropdown neben dem Composer.

4. Testnachricht senden

Geben Sie Hello, reply with ok ein und drücken Sie die Eingabetaste. Eine normale Antwort bedeutet, dass Schlüssel, Basis-URL und Modell funktionieren.

5. Funktioniert immer noch nicht?

Überprüfen Sie den Fehlertext (401, 404, Timeout), stellen Sie sicher, dass Hermes nach der Bearbeitung von .env neu gestartet wurde, oder führen Sie den API-Konnektivitätstest mit demselben Schlüssel durch.

FAQ

Problem Was zu prüfen ist
Senden schlägt fehl URL ist https://apimaster.ai/v1; Schlüssel vollständig kopiert; Modell-ID exakt; Hermes nach .env-Bearbeitung neu gestartet
Ordner fehlt Verwenden Sie ~/.hermes auf dem Mac (nicht Application Support); starten Sie Hermes einmal oder mkdir -p ~/.hermes
Kein benutzerdefinierter Endpunkt Aktualisieren Sie Hermes auf die neueste Version
Falsche Modelle IDs stammen von APIMaster; siehe Unterstützte Modelle

Optional: API-Konnektivitätstest mit demselben Schlüssel.

Sicherheit

  • Teilen Sie keine API-Schlüssel in Slack, E-Mails oder öffentlichen Dokumenten.
  • Verwenden Sie in Tickets und Screenshots ausschließlich Platzhalter.
  • Falls ein Schlüssel durchgesickert ist, widerrufen Sie ihn in der Konsole, aktualisieren Sie .env und starten Sie Hermes neu.

Checkliste

  • API-Schlüssel aus der Konsole kopiert (privat gehalten)
  • OPENAI_API_KEY in .env gesetzt
  • OPENAI_BASE_URL=https://apimaster.ai/v1 (mit /v1)
  • .env gespeichert
  • Hermes vollständig neu gestartet
  • Anbieter = Benutzerdefinierter Endpunkt, Modell-ID ausgewählt, Übernehmen geklickt
  • Testnachricht funktioniert in einer neuen Sitzung

Siehe auch