Как подключить Hermes к Tokenator API

Что получится в итоге

После настройки Hermes перестаёт обращаться к своему стандартному провайдеру и отправляет все запросы в Tokenator. Оплата идёт токенами вашего ключа, а список доступных моделей задаётся ключом, а не инструментом.

Требования и поддерживаемые ОС

• Windows 10/11, macOS 12+ или современный Linux с 64-битной архитектурой.
• Доступ в интернет к домену Tokenator по HTTPS.
• API-ключ Tokenator вида sk-your-tokenator-key.

Нужен терминал: на macOS, Linux, WSL2 и Termux установка идёт скриптом через curl, на Windows — через PowerShell. Настройки лежат в ~/.hermes/, на Windows — в %LOCALAPPDATA%\hermes.

Установка Hermes

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

После установки перезапустите оболочку и проверьте команду: hermes запускает агента, hermes model — мастер настройки провайдеров.

Настройка Tokenator

1. Зарегистрируйтесь в личном кабинете и купите пакет токенов.
2. Ключ появится в кабинете сразу после подтверждения оплаты — копировать его нужно целиком, вместе с префиксом.
3. В примерах ниже вместо настоящего ключа стоит плейсхолдер sk-your-tokenator-key. Не публикуйте настоящий ключ в репозиториях и скриншотах.

Конфигурация

1. Выйдите из активной сессии: внутри чата команда /model только переключает уже настроенное и не умеет добавлять провайдеров.
2. Запустите мастер: hermes model.
3. Выберите пункт Custom endpoint (self-hosted / VLLM / etc.).
4. API base URL: https://api.tokenator.top/v1
5. API key: sk-your-tokenator-key
6. Model name: gpt-5.5
7. Поле длины контекста можно оставить пустым — тогда она определяется автоматически.

model:
  default: gpt-5.5
  provider: custom
  base_url: https://api.tokenator.top/v1
  api_key: sk-your-tokenator-key

providers:
  tokenator:
    api: https://api.tokenator.top/v1
    key_env: TOKENATOR_API_KEY
    transport: chat_completions
    discover_models: false
    models:
      - gpt-5.5

Второй блок — именованный провайдер. Он нужен, когда эндпоинтов несколько: тогда модель выбирается тройным синтаксисом /model custom:tokenator:gpt-5.5. Ключ в этом варианте берётся из переменной окружения, названной в key_env.

TOKENATOR_API_KEY=sk-your-tokenator-key

Файлы лежат в ~/.hermes/, а на Windows — в %LOCALAPPDATA%\hermes: там те же %LOCALAPPDATA%\hermes\config.yaml и %LOCALAPPDATA%\hermes\.env.

Первый запрос

Перед запуском инструмента полезно убедиться, что ключ и модель рабочие. Один запрос curl отвечает на оба вопроса сразу.

curl https://api.tokenator.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-tokenator-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "ping"}]
  }'

cd /path/to/project
hermes

Внутри сессии модель переключается командой /model custom:gpt-5.5, а для именованного провайдера — /model custom:tokenator:gpt-5.5.

Успешный ответ означает, что ключ действителен, модель разрешена для этого ключа и апстрим доступен. Расход виден в кабинете сразу после запроса.

Переключение моделей

Список моделей показывает мастер hermes model, а внутри сессии — команда /model. При discover_models: false показывается ровно то, что перечислено в models; со значением по умолчанию Hermes опрашивает /models самого эндпоинта.

Примеры ID моделей, доступных сейчас:

• claude-haiku-4-5
• claude-opus-4-6
• claude-opus-4-7
• claude-sonnet-4-6
• gpt-5.5
• deepseek-v4-pro

Актуальные ID и характеристики — в каталоге AI-моделей; там же видно, какие модели сейчас доступны. Выбрать между близкими вариантами помогает сравнение моделей.

Настройка reasoning

Если инструмент умеет передавать поле reasoning_effort в запросе, Tokenator пробрасывает его в апстрим без изменений. Дополнительно у самого ключа есть переключатель reasoning в личном кабинете — он действует независимо от инструмента.

Частые ошибки и способы исправления

Частые вопросы

Читайте дальше