Подписка Прокси — Общий Шлюз

Представьте себе абонемент в спортзал: вы же не отдадите другу свою настоящую карту и не будете рисковать её потерять. Вместо этого вы оформите ему гостевой пропуск. Subscription Proxy — это именно такой гостевой пропуск для ваших AI-подписок.

Какую проблему он решает

Многие AI-приложения — например, OpenViking или Open WebUI — говорят на языке API OpenAI. Вы, конечно, можете дать им напрямую ключ подписки Nous Portal, но это рискованно (они могут его засветить) и неудобно (ключи истекают). Прокси решает эту проблему, запуская крошечный локальный сервер. Каждый запрос от вашего приложения проходит через него, и прокси автоматически подставляет ваши настоящие учётные данные. Ваши приложения могут использовать любой фейковый ключ — прокси незаметно подменит его на настоящий.

Чем он отличается от API-сервера

	API-сервер	Subscription Proxy
Что предоставляет	Полноценные агенты Hermes (инструменты, память, навыки)	Чистый инференс моделей
Для чего лучше всего	«Использовать Hermes как чат-бэкенд»	«Поделиться подпиской Portal с другими приложениями»
Аутентификация	Требуется ваш `API_SERVER_KEY`	Любой bearer-токен (прокси заменяет его)
Вызов инструментов	Поддерживается	Не поддерживается (чистый проходной шлюз)

Одной фразой: Используйте API-сервер, когда вам нужен агент; используйте прокси, когда вам нужна просто модель.

Три шага для начала работы

1. Войдите один раз

hermes portal

Откроется браузер со страницей авторизации Nous Portal. После входа Hermes сохранит refresh-токен в ~/.hermes/auth.json.

2. Запустите прокси

hermes proxy start

Вы увидите вывод, похожий на этот:

Starting Hermes proxy for Nous Portal
  Listening on:  http://127.0.0.1:8645/v1
  Forwarding to: (resolved per-request from your subscription)
  Use any bearer token in the client — the proxy attaches your real credential.

Хотите, чтобы он работал в фоне? Используйте tmux, nohup или systemd-сервис.

3. Настройте ваше приложение

Любому приложению, совместимому с OpenAI, нужны всего три настройки:

Base URL:   http://127.0.0.1:8645/v1
API key:    anything (e.g. "sk-unused")
Model:      Hermes-4-70B    # or Hermes-4.3-36B, Hermes-4-405B

Прокси игнорирует любой введённый вами ключ и заменяет его вашим настоящим учётным данным Portal — и автоматически обновляет его до истечения срока действия.

Проверка статуса

hermes proxy status

Вы должны увидеть ready. Если написано not logged in, запустите hermes portal ещё раз. Если написано credentials need attention, ваш refresh-токен был отозван (обычно это происходит после выхода на сайте Portal) — просто войдите заново.

Поддерживаемые конечные точки

Прокси пересылает только те пути, которые реально поддерживает вышестоящий сервер; всё остальное возвращает 404 с понятным сообщением:

Путь	Назначение
`/v1/chat/completions`	Чат-завершения (поддерживается стриминг)
`/v1/completions`	Устаревшие текстовые завершения
`/v1/embeddings`	Векторные эмбеддинги
`/v1/models`	Список доступных моделей

Резюме и практические советы

Subscription proxy — это безопасный адаптер: он позволяет другим приложениям использовать вашу подписку, не раскрывая ваш настоящий ключ, и берёт на себя заботу об истечении срока действия. Сейчас он поддерживает Nous Portal и xAI (Grok), а в будущем появятся и другие провайдеры.

Один практический совет: Если вы используете несколько приложений, дайте каждому свой фейковый ключ (например, sk-app1, sk-app2). Так в логах прокси будет точно видно, какое приложение делает какие запросы — это значительно упростит отладку. Кроме того, прокси по умолчанию слушает только 127.0.0.1. Не меняйте это на 0.0.0.0, иначе любое устройство в вашей сети сможет воспользоваться вашей подпиской.