ГлавнаяДокументация
Меню документации — Hermes Desktop
Начало
Quick StartСписок моделей
Интеграции
ОбзорCursorClaude CodeCline / Roo CodeHermes DesktopLangChainDifyCherry StudioOpen WebUIChatGPT Next WebChatbox
Guides
Какой endpoint выбратьGemini: нативный generateContentVision и файлы в чатеСтриминг (SSE)Миграция с OpenAI / AnthropicВеб-поиск и инструментыФайлы: приём и генерация
Концепции
АутентификацияRate-limits
Медиа
Генерация изображенийГенерация видеоОзвучка (TTS)Генерация музыки3D-генерацияКлонирование голоса
API Reference
EmbeddingsОшибки

Hermes Desktop

Ranvik подключается в Hermes как Custom endpoint. Отдельного пункта Ranvik в списке встроенных провайдеров не будет. Hermes работает с Ranvik через стандартный OpenAI-compatible API.

Настройка в Hermes Desktop

  1. Откройте настройки моделей и выберите Local / Custom или Custom endpoint.
  2. Укажите параметры из таблицы ниже.
  3. Сохраните провайдера, выберите модель и перезапустите текущую сессию Hermes.
Base URLhttps://api.ranvik.ru/v1
API Keyrk_live_...
Modeldeepseek-v4-pro или другой текстовый Model ID из каталога
API modeOpenAI Chat Completions

Не добавляйте /chat/completions в Base URL: Hermes сам вызывает POST /v1/chat/completions. Для работы агента выбирайте модель с поддержкой function/tool calling.

Если Ranvik не появился в интерфейсе

Закройте активную сессию Hermes и запустите мастер настройки в терминале:

hermes model

Выберите Custom endpoint (self-hosted / VLLM / etc.), затем введите Base URL, API-ключ и Model ID из таблицы. Команда /model внутри чата только переключает уже настроенных провайдеров и не добавляет новый.

Ручная настройка

Hermes хранит конфигурацию в ~/.hermes/config.yaml. В Windows это %LOCALAPPDATA%\hermes\config.yaml.

model:
  default: deepseek-v4-pro
  provider: custom
  base_url: https://api.ranvik.ru/v1
  api_key: rk_live_...
  streaming: false

После изменения файла полностью перезапустите Hermes Desktop.

Для Hermes используйте streaming: false. Большой агентский набор function-схем у некоторых моделей может задерживать первый streaming-чанк. Hermes продолжит выполнять инструменты и подзадачи, но покажет ответ целиком после завершения генерации.

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

curl https://api.ranvik.ru/v1/models \
  -H "Authorization: Bearer rk_live_..."

В ответе должен присутствовать выбранный Model ID. Затем отправьте короткое сообщение из Hermes. Запросы и списания появятся в кабинете Ranvik в разделе логов.

Частые ошибки

  • 401 — вставлен неверный или отозванный ключ. Используйте ключ формата rk_live_... без слова Bearer.
  • 402 — на балансе проекта недостаточно средств.
  • Ranvik отсутствует в списке провайдеров — это нормально; выберите Custom endpoint.
  • Модель не найдена — скопируйте точный Model ID из каталога Ranvik.
  • Модель отвечает, но агент не вызывает инструменты — выберите модель с capability function calling.

Отдельно подключать подписку или выполнять OAuth не нужно: Hermes авторизуется API-ключом, а стоимость запросов списывается с привязанного проекта Ranvik.