# Hoe Hermes Agent uitvoeren met DeepSeek API van Atlas Cloud > Een stapsgewijze handleiding voor het uitvoeren van de open-source Hermes Agent op DeepSeek V4-modellen via de OpenAI-compatibele API van Atlas Cloud, met configuratievoorbeelden en prijzen. Je hebt Hermes Agent geïnstalleerd, de open-source autonome agent van Nous Research, en je hebt nu een model nodig dat goedkoop genoeg is om de hele dag te draaien en krachtig genoeg om echte toolcalls aan te kunnen. [DeepSeek](https://www.atlascloud.ai/models/list/llm?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=run-hermes-agent-deepseek-api-atlascloud) V4 is een voor de hand liggende keuze qua kosten, en Atlas Cloud biedt de DeepSeek-familie aan via één enkel OpenAI-compatibel eindpunt, naast 300+ andere modellen. Deze gids leidt je door het aansluiten van Hermes Agent op DeepSeek op Atlas Cloud, van de basis-URL en model-ID's tot een werkende `config.yaml`, zodat de agent draait op productieklare infrastructuur zonder een tweede SDK. ## Wat je met elkaar verbindt Hermes Agent is een persistente, zelfverbeterende agent die op je eigen server draait. Het is ontworpen om model- en provider-agnostisch te zijn, dus het maakt niet uit of DeepSeek-tokens rechtstreeks van DeepSeek komen of via een gateway, zolang het eindpunt de OpenAI API-vorm spreekt. Atlas Cloud is een volledig modaal AI-inferentieplatform dat tekst-, afbeeldings- en videomodellen aanbiedt via één OpenAI-compatibele API-sleutel en één facturatieaccount. Omdat het oppervlak OpenAI-compatibel is, is het verbinden van Hermes een kwestie van het wijzigen van de basis-URL en sleutel, niet van een herschrijving. Die combinatie is belangrijk voor een persistente agent. Hermes is gebouwd om wekenlang te draaien, waarbij het geheugen en herbruikbare vaardigheden verzamelt, dus het model erachter is een terugkerende kostenpost in plaats van een eenmalige aanroep. DeepSeek V4 houdt die terugkerende kosten laag zonder in te boeten aan kwaliteit van toolcalls, en door het via Atlas Cloud te routeren, kan dezelfde sleutel die een chatbeurt beantwoordt later een afbeelding of videoclip genereren wanneer een vaardigheid erom vraagt. Je kiest niet alleen een goedkoop model, je kiest een eindpunt waar de agent niet uit zal groeien. Twee feiten bepalen de hele opzet, en het is de moeite waard om beide precies goed te krijgen voordat je een config-bestand aanraakt: * De Atlas Cloud basis-URL is `https://api.atlascloud.ai/v1`. * DeepSeek-model-ID's op Atlas Cloud hebben het voorvoegsel `deepseek-ai/`, bijvoorbeeld `deepseek-ai/deepseek-v4-pro`. Dit verschilt van de kale `deepseek-v4-pro` die Hermes gebruikt met zijn ingebouwde DeepSeek-provider, die naar DeepSeek's eigen eindpunt verwijst. Wanneer je via Atlas Cloud routeert, gebruik je het volledige voorvoegsel-ID en een aangepaste OpenAI-compatibele provider, niet de ingebouwde. ## Stap 1: Haal je Atlas Cloud API-sleutel op Log in op console.atlascloud.ai, open API Keys, klik op Create API Key en kopieer deze naar een veilige plek. Toegang is pay-as-you-go, dus er is geen storting of minimale uitgave. Je registreert je, krijgt een sleutel en betaalt per verzoek. Houd de sleutel buiten versiebeheer. Hermes scheidt geheimen van instellingen met opzet: `config.yaml` bevat niet-gevoelige structuur en is veilig om te committen of te delen, terwijl `~/.hermes/.env` sleutels bevat en standaard wordt genegeerd door git. Door de Atlas Cloud-sleutel in `.env` te plaatsen en er vanuit de config naar te verwijzen met de naam, kun je je agent-opzet versiebeheren zonder dat je een inloggegevens lekt. ``` echo "ATLASCLOUD_API_KEY=your-atlas-cloud-key" >> ~/.hermes/.env ``` ## Stap 2: Bevestig de DeepSeek-model-ID's die je kunt aanroepen Atlas Cloud publiceert zijn live modellenlijst op een openbaar eindpunt, zodat je nooit naar een ID hoeft te raden. Een snelle aanroep geeft de exacte tekenreeksen terug die de API accepteert. ``` curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Het eerst opvragen van de lijst is geen overbodige luxe. Model-ID's verschuiven naarmate nieuwe versies worden uitgebracht, en een verouderd ID uit een blogpost of een oud script is de meest voorkomende reden waarom een eerste aanroep mislukt. Het `/v1/models`-eindpunt is de waarheid over wat de API vandaag zal accepteren, dus door het te controleren voordat je een config bewerkt, bespaar je een ronde van fouten met onbekende modellen. De DeepSeek-vermeldingen die je het vaakst zult gebruiken, zijn deze: | Model-ID | Het beste voor | Contextvenster | |---|---|---| | `deepseek-ai/deepseek-v4-pro` | Hoofdagent-lus, coderen, toolcalls | 1M tokens | | `deepseek-ai/deepseek-v4-flash` | Hulptaken, hoge doorvoer | 1M tokens | | `deepseek-ai/deepseek-v3.2` | Kostenbewuste algemene chat | 163K tokens | DeepSeek V4 Pro kost $1,68 per miljoen invoertokens en $3,38 per miljoen uitvoertokens op Atlas Cloud, terwijl V4 Flash $0,14 invoer en $0,28 uitvoer kost. Dat verschil is de hele reden om hoofd- en hulpwerk over de twee te verdelen, wat de onderstaande config doet. ## Stap 3: Wijs Hermes naar Atlas Cloud Omdat Atlas Cloud een aangepast OpenAI-compatibel eindpunt is, in plaats van Hermes' ingebouwde DeepSeek-provider, definieer je het expliciet in `~/.hermes/config.yaml`. Het providerblok geeft de basis-URL en de omgevingsvariabele die je sleutel bevat, en het modelblok selecteert het voorvoegsel DeepSeek-ID. ``` inference: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: default: deepseek-ai/deepseek-v4-pro ``` Sla het bestand op en start de agent. ``` hermes ``` Als het eerste bericht een normaal antwoord teruggeeft, is de bedrading correct. Als je een authenticatiefout krijgt, is de sleutel in `.env` onjuist of niet geladen; als je een fout met onbekend model krijgt, controleer dan het `deepseek-ai/`-voorvoegsel opnieuw met de uitvoer van `/v1/models` uit stap 2. De meest voorkomende fout hier is het grijpen naar Hermes' ingebouwde `deepseek`-provider terwijl je verwacht dat Atlas Cloud antwoordt. De ingebouwde provider is vast verbonden met DeepSeek's eigen eindpunt en de kale modelnamen, dus het zal je DeepSeek-account gewoon factureren en Atlas Cloud volledig negeren. Het routeren via Atlas Cloud is een bewuste keuze voor een aangepaste provider: je eigen `base_url`, je Atlas Cloud-sleutel en de voorvoegsel `deepseek-ai/` model-ID's. Houd die drie bij elkaar en de twee paden raken nooit in de war. ## Stap 4: Stuur goedkoop werk naar Flash Hermes voert achter de schermen veel laagwaardige aanroepen uit: websamenvatting, visuele analyse, contextcompressie, commando-goedkeuring. V4 Pro-tarieven betalen voor die verspilling is zonde. Wijs de hulpslots naar V4 Flash, zodat de hoofdlus het sterkere model houdt terwijl de achtergrondtaken voor een fractie van de kosten draaien. ``` auxiliary: web_extract: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash compression: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash timeout: 120 ``` Elke hulpslot accepteert zijn eigen provider, model, basis-URL, sleutel en fallback-keten, zodat je elke achtergrondtaak onafhankelijk kunt afstemmen. ## Stap 5: Voeg een fallback toe voor veerkracht Een langlopende agent zal uiteindelijk een snelheidslimiet of een time-out tegenkomen. Een fallback-keten zorgt ervoor dat hij blijft werken in plaats van te stoppen met een foutmelding. Hier probeert de compressietaak eerst V4 Flash, en valt dan terug naar een tweede Atlas Cloud-model voordat hij opgeeft. ``` auxiliary: compression: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash fallback_chain: - provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v3.2 ``` Hermes probeert elk item in volgorde totdat er een slaagt, dus een enkele provider-hickup stopt de agent niet. Voor een agent die onbeheerd op een schema draait, is dit het verschil tussen een cron-job die stilletjes herstelt en een die om 3 uur 's nachts doodgaat en je 's ochtends een stacktrace achterlaat. ## Wanneer deze opzet de juiste keuze is Het draaien van Hermes op DeepSeek via Atlas Cloud is het meest zinvol wanneer je één sleutel en één factuur wilt voor alles wat de agent aanraakt. Omdat hetzelfde eindpunt ook afbeeldings- en videomodellen bedient, kan een agent die begint als alleen tekst later afbeeldingen of clips genereren zonder een nieuwe integratie of een tweede leveranciersaccount. Als je agent alleen maar DeepSeek zal aanroepen en niets anders, is de ingebouwde DeepSeek-provider die naar DeepSeek's eigen API wijst het eenvoudigere pad. De Atlas Cloud-route verdient zijn plaats zodra je ruimte wilt hebben om modellen over modaliteiten heen toe te voegen, achter één enkel, OpenAI-compatibel oppervlak. Je kunt elke model-ID en live prijs zelf bevestigen op atlascloud.ai/models voordat je dit allemaal in een config-bestand vastlegt, een gewoonte die het waard is om te behouden naarmate de DeepSeek-line-up evolueert. Voor gerelateerde implementatiehandleidingen, zie [het schakelen van een OpenAI-compatibele toepassing naar andere LLM's](https://ask.atlascloud.ai/what-api-provider-lets-me-switch-from-openai-to-other-llms) en [het evalueren van een AI-inferentie-API voor productie](https://ask.atlascloud.ai/what-to-evaluate-before-choosing-ai-inference-api).