NIEUW 📢 Beperkte lanceeractie: tot 70% korting op je eerste maand, voor elke game!Bekijk pakketten

Welke sleutel van een AI-provider je gebruikt met Hermes Agent

Hermes AgentUpdated Nov 7, 20266 min read

Kort antwoord. Hermes Agent bevat geen model: het heeft een account bij een AI-provider nodig. Op PlayNHost plak je een API-sleutel van OpenAI, Anthropic, Google Gemini, xAI of OpenRouter, en één sleutel is genoeg. Hermes Agent kiest de provider aan de hand van de sleutel, en je kiest het model vanuit de chat met /model. Wil je veel modellen achter één sleutel en één rekening, gebruik dan OpenRouter. Je provider rekent het modelgebruik rechtstreeks met je af; het serverabonnement omvat dat niet.

Gecontroleerd op 7 november 2026, geldig voor Hermes Agent v0.23.0.

Deze gids gebruikt de provider- en configuratiedocumentatie van Hermes Agent, de broncode van v0.23.0 waar de documentatie zwijgt, en het PlayNHost-paneel zoals het nu werkt.

De vijf sleutels die het paneel accepteert

ProviderVeld op de pagina AgentWaar de sleutel vandaan komtNaam die Hermes Agent leest
OpenAIOpenAI API-sleutelJe OpenAI Platform-accountOPENAI_API_KEY
AnthropicAnthropic API-sleutelDe Anthropic Console (console.anthropic.com)ANTHROPIC_API_KEY
Google GeminiGoogle Gemini API-sleutelGoogle AI Studio (aistudio.google.com/app/apikey)GEMINI_API_KEY, die Hermes Agent als alias van GOOGLE_API_KEY behandelt
xAIxAI API-sleutelDe xAI-console (console.x.ai)XAI_API_KEY
OpenRouterOpenRouter API-sleutelJe OpenRouter-accountOPENROUTER_API_KEY

Een API-sleutel wordt per gebruik afgerekend. Een abonnement voor consumenten is iets anders: de documentatie van Hermes Agent zegt dat een Claude Pro-abonnement niet via zijn inlogmethode gebruikt kan worden, en dat het ondersteunde alternatief een Anthropic API-sleutel is, per token afgerekend.

Welke je kiest

  • Je betaalt al bij één provider: gebruik die sleutel.
  • Je wilt meerdere modellen proberen: OpenRouter zet veel providers achter één sleutel en één rekening. De eigen documentatie van Hermes Agent noemt het "recommended for flexibility" (aanbevolen voor flexibiliteit).
  • Je denkt aan een gratis laag: de documentatie van Hermes Agent waarschuwt dat een gratis Google Gemini-sleutel na een handvol agentbeurten op kan zijn, omdat één bericht van jou meerdere modelaanroepen kan kosten. Andere kleine gratis tegoeden raken om dezelfde reden op.
  • Het model heeft een grote context nodig. Hermes Agent vereist minstens 64.000 tokens context en weigert kleinere vensters bij het opstarten. Controleer het contextvenster van het model dat je kiest, zeker als het een klein model is.
  • Niet op PlayNHost: Nous Portal en andere inlogmethoden (een ChatGPT-, Claude Max- of SuperGrok-login) hebben hermes model of hermes setup op een opdrachtregel nodig, en lokale modellen (Ollama, LM Studio) hebben een modelserver nodig die het abonnement niet omvat. Het paneel accepteert API-sleutels.

Voeg de sleutel toe op PlayNHost

  1. Open je server op panel.playnhost.com en dan het tabblad Agent.
  2. Druk onder AI-provider ("Eén sleutel is genoeg. Elke provider rekent af met je eigen account voor wat je agent gebruikt.") op Instellen in de rij van je provider, plak de sleutel en druk op Opslaan. De rij toont daarna alleen de laatste vier tekens. De sleutel wordt versleuteld bewaard en nooit meer getoond; met Vervangen en Verwijderen wijzig je hem later.
  3. Voeg een Telegram- of Discord-bottoken toe als je dat nog niet hebt gedaan (Telegram, Discord), en start of herstart dan de agent: "Wijzigingen gelden de volgende keer dat je agent start."

De sleutel bereikt Hermes Agent via zijn omgeving, onder de naam uit de tabel. Hermes Agent bewaart er een vingerafdruk van in auth.json, niet de sleutel zelf (dat hebben we op een testserver gecontroleerd).

Kies het model vanuit de chat

PlayNHost heeft voor Hermes Agent geen modelveld: je kiest in de chat, met de eigen opdracht van Hermes Agent.

  • Stuur je bot /model. In Telegram opent dat een keuzelijst: eerst de providers waarvoor je een sleutel hebt, daarna hun modellen. Het huidige model staat bovenaan.
  • Ken je de naam van het model, stuur dan /model <name>. Voeg --global toe om het ook voor nieuwe gesprekken te bewaren.
  • /model schakelt alleen tussen providers waarvoor je een sleutel hebt. Voor een andere provider voeg je zijn sleutel toe op de pagina Agent en herstart je.

De documentatie van Hermes Agent voegt één kostenopmerking toe: van model wisselen midden in een lang gesprek zorgt ervoor dat het volgende bericht het hele gesprek opnieuw tegen volle prijs inleest, omdat de promptcache van de provider bij het oude model hoort. Wissel vroeg, of na /new.

Meerdere sleutels tegelijk

Je kunt er meer dan één instellen. Als in de instellingen van Hermes Agent geen provider is gekozen, neemt de code van v0.23.0 eerst een OpenRouter-sleutel; ontbreekt die, dan neemt hij de eerste provider met een sleutel in zijn eigen ingebouwde lijst. Om verrassingen te voorkomen houd je één sleutel, of kies je de provider met /model.

Houd de rekening in de hand

  • Je provider rekent met je af, wij niet. PlayNHost verkoopt modelgebruik niet door en zet het niet op je rekening; het abonnement betaalt de server.
  • Stel bij je provider een bestedingslimiet of budgetmelding in. Hermes Agent kan zelf geplande taken uitvoeren, en elke run gebruikt je sleutel terwijl jij niet kijkt.
  • Bijtaken gebruiken je hoofdmodel. Standaard stuurt Hermes Agent zijn bijtaken (contextcompressie, afbeeldingen lezen, sessietitels, beoordelen of een opdracht riskant is) naar je hoofdmodel. De documentatie merkt op dat dit bij een duur model flink wat kosten toevoegt.
  • Alleen jij kunt hem berichten. De ID-lijsten op de pagina Agent houden vreemden ervan af je tegoed te verbruiken.

Op je eigen machine

Draai hermes model om een provider en model te kiezen (het vraagt om de sleutel of start de inlog van de provider), of zet de sleutel in ~/.hermes/.env:

OPENROUTER_API_KEY=sk-or-...

Herstart daarna de gateway. Zie Hermes Agent 24/7 draaien, of maak een Hermes Agent-server aan en plak je sleutel in het paneel.

PlayNHost is niet verbonden aan Nous Research. Hermes Agent is open-sourcesoftware onder de MIT-licentie.

Draait je server al ergens anders? Verhuis hem naar ons

ONZE NIEUWSTE BLOGS