APIMaster.ai
Документация APIMaster.ai
Quick startAPIMaster.aiMarketplace

Hermes Desktop с APIMaster.ai

Установите OpenAI-совместимый API-ключ и базовый URL в Hermes Desktop на Windows или macOS, затем выберите модель в настройках.

APIMaster.ai совместим с OpenAI. Hermes считывает две переменные окружения, после чего вы выбираете модель в интерфейсе рабочего стола.

Быстрая настройка

Шаг 1 — Получите ваш API-ключ

  1. Откройте консоль APIMaster.
  2. Скопируйте ваш API-ключ (обычно начинается с sk-).
  3. Никогда не вставляйте настоящий ключ в чат или скриншоты; используйте плейсхолдер your_apimaster_key ниже.

Шаг 2 — Отредактируйте файл .env

Windows

  1. Нажмите Win + R, вставьте и нажмите Enter:

    %LOCALAPPDATA%\hermes

  2. Откройте .env в Блокноте (создайте файл, если его нет).

  3. Типичный полный путь:

    C:\Users\ВашеИмя\AppData\Local\hermes\.env

macOS

Hermes Desktop использует общую папку ~/.hermes с CLI (официальная документация). Поместите ключи в ~/.hermes/.env.

Вариант A — Finder (рекомендуется)

  1. Переход → Перейти к папке… (Shift + Command + G).

  2. Вставьте:

    ~/.hermes

    (~ = ваша домашняя папка; .hermes скрыта в Finder, если не использовать «Перейти к папке».)

  3. Откройте .env в TextEdit (создайте, если отсутствует).

Вариант B — Терминал

open ~/.hermes

Полный путь

/Users/ВашеИмя/.hermes/.env

Шаг 3 — Добавьте эти строки

OPENAI_API_KEY=your_apimaster_key
OPENAI_BASE_URL=https://apimaster.ai/v1
  • OPENAI_BASE_URL должен заканчиваться на /v1 — не просто https://apimaster.ai.
  • Без пробелов вокруг =, без кавычек, если документация Hermes не указывает иное.
  • Сохраните файл.

Шаг 4 — Перезапустите Hermes Desktop

Полностью закройте Hermes (включая иконку в трее), затем откройте снова.

Выберите модель в приложении

  1. Откройте Hermes Desktop.

  2. Перейдите в Настройки → Модель → Основная модель.

  3. Провайдер: Пользовательская конечная точка.

  4. Модель: выберите поддерживаемый идентификатор модели, например:

    • claude-opus-4-8
    • claude-sonnet-4-6
    • gpt-5.5
    • gpt-5.4

    Полный список смотрите в маркетплейсе или у вашего администратора.

  5. Нажмите Применить, затем закройте Настройки.

Hermes Desktop: Настройки → Модель → Основная модель

Тест: выберите модель и отправьте сообщение

1. Установите основную модель в Настройках (обязательно)

  1. Откройте Настройки (боковая панель или слева внизу).
  2. Перейдите в Модель → Основная модель.
  3. Провайдер: Пользовательская конечная точка (или openai-api, если отображается).
  4. Откройте выпадающий список Модель и нажмите на идентификатор (например, gpt-5.4) — не вводите отображаемое имя.
  5. Нажмите Применить и закройте Настройки.

Новые чаты используют эту модель после нажатия «Применить»; старые чаты могут по-прежнему использовать предыдущую.

2. Начните новый чат

  1. Вернитесь к списку чатов.
  2. Нажмите Новый чат (или +).
  3. Используйте новую сессию, а не старую ветку.

3. Проверьте активную модель (рекомендуется)

Рядом с полем ввода вы можете увидеть что-то вроде openai-api / gpt-5.4. Если это неверно, исправьте Основную модель, нажмите «Применить» и откройте еще один новый чат. В некоторых сборках также есть небольшой выпадающий список модели рядом с композером.

4. Отправьте тестовое сообщение

Введите Hello, reply with ok и нажмите Enter. Нормальный ответ означает, что ключ, базовый URL и модель работают.

5. Всё еще не работает?

Проверьте текст ошибки (401, 404, таймаут), убедитесь, что Hermes был перезапущен после редактирования .env, или запустите тест подключения к API с тем же ключом.

Часто задаваемые вопросы

Проблема Что проверить
Отправка не удается URL — https://apimaster.ai/v1; ключ скопирован полностью; идентификатор модели точный; Hermes перезапущен после редактирования .env
Папка отсутствует Используйте ~/.hermes на Mac (не Application Support); запустите Hermes один раз или выполните mkdir -p ~/.hermes
Нет «Пользовательской конечной точки» Обновите Hermes до последней версии
Неправильные модели Идентификаторы предоставляются APIMaster; см. Поддерживаемые модели

Опционально: тест подключения к API с тем же ключом.

Безопасность

  • Не делитесь API-ключами в Slack, электронной почте или публичных документах.
  • Используйте плейсхолдеры только в тикетах и скриншотах.
  • Если ключ утек, отзовите его в консоли, обновите .env и перезапустите Hermes.

Контрольный список

  • API-ключ скопирован из консоли (оставлен в секрете)
  • OPENAI_API_KEY установлен в .env
  • OPENAI_BASE_URL=https://apimaster.ai/v1 (с /v1)
  • .env сохранен
  • Hermes полностью перезапущен
  • Провайдер = Пользовательская конечная точка, выбран идентификатор модели, нажато Применить
  • Тестовое сообщение работает в новой сессии

Смотрите также