НОВОЕ 📢 Ограниченное стартовое предложение: скидка до 70% на первый месяц для любой игры!Посмотреть тарифы

Какой API-ключ выбрать для Hermes Agent

Hermes AgentUpdated Nov 7, 20266 min read

Коротко. В Hermes Agent нет собственной модели: ему нужна учётная запись у ИИ-провайдера. На PlayNHost вы вставляете API-ключ от OpenAI, Anthropic, Google Gemini, xAI или OpenRouter, и одного ключа достаточно. Hermes Agent определяет провайдера по ключу, а модель вы выбираете из чата командой /model. Если нужно много моделей за одним ключом и одним счётом, берите OpenRouter. Использование модели оплачивается напрямую вашему провайдеру; в тариф сервера оно не входит.

Проверено 7 ноября 2026, актуально для Hermes Agent v0.23.0.

В этом руководстве использованы документация Hermes Agent по провайдерам и настройке, его исходный код v0.23.0 там, где документация молчит, и панель PlayNHost в её нынешнем виде.

Пять ключей, которые принимает панель

ПровайдерПоле на странице AgentОткуда берётся ключИмя, которое читает Hermes Agent
OpenAIAPI-ключ OpenAIВаш аккаунт OpenAI PlatformOPENAI_API_KEY
AnthropicAPI-ключ AnthropicAnthropic Console (console.anthropic.com)ANTHROPIC_API_KEY
Google GeminiAPI-ключ Google GeminiGoogle AI Studio (aistudio.google.com/app/apikey)GEMINI_API_KEY, который Hermes Agent считает псевдонимом GOOGLE_API_KEY
xAIAPI-ключ xAIКонсоль xAI (console.x.ai)XAI_API_KEY
OpenRouterAPI-ключ OpenRouterВаш аккаунт OpenRouterOPENROUTER_API_KEY

API-ключ оплачивается по факту использования. Потребительская подписка это другое: в документации Hermes Agent сказано, что тариф Claude Pro нельзя использовать через его вход, а поддерживаемая альтернатива это API-ключ Anthropic с оплатой за токены.

Какой выбрать

  • Вы уже платите одному провайдеру: используйте его ключ.
  • Хотите попробовать несколько моделей: OpenRouter объединяет многих провайдеров за одним ключом и одним счётом. Документация Hermes Agent сама называет его «recommended for flexibility» (рекомендуется для гибкости).
  • Думаете о бесплатном уровне: документация Hermes Agent предупреждает, что бесплатный ключ Google Gemini может закончиться уже после горстки ходов агента, потому что одно ваше сообщение может вызвать несколько обращений к модели. Другие небольшие бесплатные квоты заканчиваются по той же причине.
  • Модели нужен большой контекст. Hermes Agent требует не менее 64 000 токенов контекста и при запуске отклоняет меньшие окна. Проверьте окно контекста выбранной модели, особенно небольшой.
  • Не на PlayNHost: Nous Portal и другие способы входа (вход через ChatGPT, Claude Max или SuperGrok) требуют hermes model или hermes setup в командной строке, а локальным моделям (Ollama, LM Studio) нужен сервер моделей, которого в тарифе нет. Панель принимает API-ключи.

Добавьте ключ на PlayNHost

  1. Откройте свой сервер на panel.playnhost.com, затем вкладку Агент.
  2. В разделе ИИ-провайдер («Достаточно одного ключа. Каждый провайдер списывает с вашего собственного аккаунта то, что использует агент.») нажмите Задать в строке своего провайдера, вставьте ключ и нажмите Сохранить. После этого в строке видны только последние четыре символа. Ключ хранится в зашифрованном виде и больше никогда не показывается; позже его можно изменить через Заменить и Удалить.
  3. Добавьте токен бота Telegram или Discord, если ещё не добавили (Telegram, Discord), затем запустите или перезапустите агента: «Изменения применятся при следующем запуске вашего агента.»

Ключ попадает в Hermes Agent через его окружение под именем из таблицы. Hermes Agent хранит в auth.json отпечаток ключа, а не сам ключ (мы проверили это на тестовом сервере).

Выберите модель из чата

В PlayNHost для Hermes Agent нет поля модели: вы выбираете в чате собственной командой Hermes Agent.

  • Отправьте /model своему боту. В Telegram откроется выбор: сначала провайдеры, для которых у вас есть ключ, затем их модели. Текущая модель показана сверху.
  • Если вы знаете название модели, отправьте /model <name>. Добавьте --global, чтобы она сохранилась и для новых разговоров.
  • /model переключает только между провайдерами, для которых у вас есть ключ. Для другого провайдера добавьте его ключ на странице Agent и перезапустите.

Документация Hermes Agent добавляет одно замечание о расходах: смена модели посреди долгого разговора заставляет следующее сообщение перечитать весь разговор по полной цене, потому что кэш промптов провайдера принадлежит старой модели. Меняйте модель в начале или после /new.

Несколько ключей сразу

Можно задать больше одного. Когда в настройках Hermes Agent провайдер не выбран, его код v0.23.0 сначала берёт ключ OpenRouter; если его нет, берёт первого провайдера с ключом из собственного встроенного списка. Чтобы избежать сюрпризов, держите один ключ или выберите провайдера через /model.

Как держать счёт под контролем

  • Счёт вам выставляет ваш провайдер, а не мы. PlayNHost не перепродаёт использование моделей и не добавляет его в ваш счёт; тариф оплачивает сервер.
  • Задайте лимит расходов или оповещение о бюджете у провайдера. Hermes Agent умеет сам запускать задания по расписанию, и каждый запуск расходует ваш ключ, пока вы не смотрите.
  • Побочные задачи используют вашу основную модель. По умолчанию Hermes Agent отправляет свои побочные задачи (сжатие контекста, чтение изображений, названия сессий, оценку риска команды) вашей основной модели. В его документации отмечено, что с дорогой моделью они заметно добавляют к расходам.
  • Писать ему можете только вы. Списки ID пользователей на странице Agent не дают посторонним тратить ваши средства.

На своей машине

Выполните hermes model, чтобы выбрать провайдера и модель (он спросит ключ или запустит вход у провайдера), или впишите ключ в ~/.hermes/.env:

OPENROUTER_API_KEY=sk-or-...

Затем перезапустите шлюз. См. как запустить Hermes Agent 24/7 или создайте сервер Hermes Agent и вставьте ключ в панели.

PlayNHost не связан с Nous Research. Hermes Agent это программное обеспечение с открытым исходным кодом по лицензии MIT.

Ваш сервер уже у другого хостинга? Перенесите его к нам

ПОСЛЕДНИЕ БЛОГИ