Hermes Agent

Запускайте Hermes Agent через его custom OpenAI-compatible endpoint.

Hermes Agent от Nous Research

Что поддерживается

Hermes подключается к OneProvider как custom provider в режиме Chat Completions с совместимым model ID, который вы выбираете в каталоге.

Ограничение клиента

Оставьте API mode в значении Chat Completions: другие режимы Hermes не используют это OpenAI-compatible подключение.

Настройка

1. Откройте настройку модели Hermes

   Запустите мастер моделей и выберите Custom endpoint (self-hosted / VLLM / etc.).

   hermes model

2. Введите подключение OneProvider

   Укажите https://api.oneprovider.dev/v1, отдельный ключ OneProvider, совместимый model ID, выбранный вами в каталоге, и Chat Completions как API mode.

   Endpoint: https://api.oneprovider.dev/v1
   API key: sk-your-key-here
   Model: gpt-5.6-terra
   Mode: Chat Completions

3. Или настройте Hermes вручную

   Сохраните ONEPROVIDER_API_KEY=… в ~/.hermes/.env, затем задайте блок model в ~/.hermes/config.yaml.

   # ~/.hermes/.env
   ONEPROVIDER_API_KEY=sk-your-key-here
   # ~/.hermes/config.yaml
   model:
   default: gpt-5.6-terra
   provider: custom
   base_url: https://api.oneprovider.dev/v1
   key_env: ONEPROVIDER_API_KEY

Проверка подключения

Запустите новую сессию Hermes

Задайте короткий вопрос и подтвердите настроенный model ID, расход токенов и списание в dashboard OneProvider.

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

Протокол

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Безопасность ключа

Используйте отдельный inference key с ограничениями модели, rate, spend и expiry. Храните ключ в ~/.hermes/.env, а не в config.yaml.

Какую модель выбрать

Задайте default в блоке model файла config.yaml. gpt-5.6-terra хороший вариант на каждый день, gpt-6.1-sol топовый уровень для сложных задач, gpt-5.6-luna дёшев для быстрых и массовых задач. Режим API выберите Chat Completions, id копируйте со страницы моделей .

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

401

Ключ не читается: проверьте, что ONEPROVIDER_API_KEY=… лежит в ~/.hermes/.env, а key_env в config.yaml называет ту же переменную.

404

base_url должен быть https://api.oneprovider.dev/v1 с /v1.

«Model not found»

Такого id нет в каталоге или в нём опечатка. Скопируйте его со страницы моделей.

429 «Insufficient balance»

Баланс или лимит ключа исчерпан. Пополните кабинет.

В мастере нет OneProvider

Выберите Custom endpoint в hermes model: OneProvider добавляется как custom OpenAI-совместимый endpoint.

Вопросы и ответы

Где хранить ключ?

В ~/.hermes/.env, а не в config.yaml.

Можно ли использовать модели Claude?

Да, укажите id Claude, например claude-sonnet-5-5, в том же custom endpoint; возможности зависят от модели.

Как проверить, что работает?

Начните новую сессию, задайте короткий вопрос и найдите запрос в разделе «Расход» кабинета.

Быстрые ответы

Какой base URL использовать?

Claude Code и Anthropic SDK работают с https://api.oneprovider.dev. OpenAI SDK и OpenAI-совместимые клиенты работают с https://api.oneprovider.dev/v1. За обоими адресами один ключ; список моделей: странице моделей , ставки на странице тарифов .

Как авторизоваться?

Передайте сырой ключ sk-… в заголовке x-api-key или Authorization: Bearer: один из двух, не оба. Храните ключ в переменной окружения, а не в файле, который попадает в репозиторий. Подробнее об аутентификации .

Где взять ключ?

Откройте кабинет в Telegram-боте @oneprovider_robot или на app.oneprovider.dev, пополните баланс и нажмите «Выпустить ключ». У каждого ключа может быть свой лимит расхода. Кабинет и ключи .

Что значат ошибки 401, 404 и 429?

401: ключ не задан, написан с ошибкой или передан не в том заголовке; вставьте ключ целиком, без кавычек и пробелов. 404: обычно неверный base URL, например лишний или двойной /v1. 429 с текстом «Insufficient balance»: баланс кабинета или лимит ключа исчерпан, пополните его вместо повторов; любой другой 429 это лимит частоты, подождите Retry-After. Разбор: коды ошибок и решение проблем .

Почему обрывается стрим или сбрасывается соединение?

VPN и VLESS-прокси часто буферизуют SSE или ломают согласование HTTP/2. У OneProvider нет региональных ограничений, и стримы на нашей стороне не буферизуются: отключите прокси и повторите запрос.

Куда писать, если не помогло?

Напишите в Telegram @Oneproviderhelpbot или откройте «Поддержку» в веб-кабинете: приложите код статуса и точный текст ошибки. Как работает поддержка .