Доступно

Hermes Agent через API Токенмоста

Подключение Hermes Agent к OpenAI-совместимому Chat Completions: custom endpoint, ключ, модель, тест tools и контроль расходов.

API Токенмоста работает

Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.

Как это устроено

Hermes Agent принимает пользовательский OpenAI-совместимый endpoint. Для Токенмоста укажите https://tokenmost.ru/v1 и точный ID текстовой модели. Hermes может выполнять многошаговые действия, поэтому сначала проверьте обычный ответ, затем инструменты на тестовом каталоге и бюджет отдельного ключа.

Что потребуется

Установленный Hermes Agent и доступ к ~/.hermes/config.yaml.
Положительный баланс и отдельный ключ Токенмоста с небольшим бюджетом и RPM.
Точный ID модели с доступным Chat Completions и проверенной поддержкой tools для агентных действий.

Порядок работы

Создайте отдельный API-ключ для Hermes и сохраните его в переменной TOKENMOST_API_KEY.
Запустите hermes model, выберите Custom endpoint и задайте base URL https://tokenmost.ru/v1, ключ и точный ID модели.
Проверьте созданный ~/.hermes/config.yaml: provider должен быть custom, а base_url — адресом /v1 без /chat/completions.
В новой сессии Hermes попросите краткий текстовый ответ без инструментов.
Затем разрешите только чтение тестового файла и проверьте, что Hermes корректно получил tool result.
Посмотрите фактический расход и ошибки в истории запросов Токенмоста, прежде чем повышать бюджет ключа.

Готовая конфигурация

Ключ — macOS и Linux

export TOKENMOST_API_KEY="sk-tm-..."
hermes model

Ключ — Windows PowerShell

$env:TOKENMOST_API_KEY = "sk-tm-..."
hermes model

~/.hermes/config.yaml — после выбора Custom endpoint

model:
  provider: custom
  default: MODEL_ID_FROM_CATALOG
  base_url: https://tokenmost.ru/v1
  key_env: TOKENMOST_API_KEY

Что учесть

Для Hermes нужен совместимый Chat Completions и модель с tools. Пользовательское подключение не означает, что каждый агентный режим конкретной версии клиента проверен Токенмостом.

Как понять, что работает

После настройки /model показывает custom-модель, а короткий вопрос возвращает текст. Для агентного режима дополнительно проверьте успешный вызов инструмента и возврат его результата; HTTP 200 одиночного диалога для этого недостаточно.

Секрет и конфигурация

Мастер hermes model может записать ключ в конфигурацию. Если редактируете файл вручную, используйте key_env вместо буквального секрета и ограничьте доступ к ~/.hermes. На Windows это каталог .hermes в домашнем каталоге пользователя.

Путь API

Hermes добавляет /chat/completions к base_url. В настройке нужен только https://tokenmost.ru/v1. OPENAI_BASE_URL относится к встроенному провайдеру openai-api; для custom надёжнее base_url в config.yaml или мастер hermes model.

Повторы и деньги

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

Ошибки и диагностика

HTTP 404 /v1/chat/completions/models

Уберите полный метод из base_url. Нужен адрес https://tokenmost.ru/v1.

HTTP 401

Проверьте переменную TOKENMOST_API_KEY в процессе Hermes и настройки key_env.

Модель не найдена

Скопируйте точный ID из каталога и проверьте опубликованный тариф и доступность Chat Completions.

Инструмент не вызывается

Проверьте tools у выбранной модели и разрешения Hermes в тестовом каталоге; обычный текстовый ответ не проверяет этот путь.

HTTP 402, 429 или 503

Проверьте баланс, бюджет, RPM, Retry-After и историю операции. Не запускайте новый платный запрос вслепую.

Источники и связанные инструкции

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

← Все инструкции