Блог

Gemini 4 в Hermes Agent: подключение Hydrogen, Carbon и Argon по одному API-ключу

Коротко

Hermes Agent (Nous Research) работает с любым эндпоинтом, совместимым с OpenAI, поэтому Gemini 4 в нём можно запускать через TeamoRouter — один API-ключ, без аккаунта Google:

  1. Запустите hermes model и выберите Custom endpoint.
  2. Base URL https://api.teamorouter.com/v1, ваш ключ TeamoRouter, модель gemini-4-hydrogen (или gemini-4-carbon, gemini-4-argon).
  3. Начните сессию. Позже модель меняется командой /model custom:gemini-4-carbon.

Тот же ключ запускает в Hermes и Claude, GPT и другие модели — между ними можно переключаться в одной сессии.

Google пишет «User location is not supported»? Gemini API доступен не во всех странах. Через TeamoRouter Gemini 4 Hydrogen, Carbon и Argon работают с одним ключом и без аккаунта Google — как подключить или получить API-ключ.

Получить API-ключ для Hermes Agent

У новых аккаунтов баланс равен $0 — пополните его перед первым запросом. Пополнить можно от $5. Если запрос возвращает 402 (400 в формате OpenAI) с текстом «wallet balance is insufficient», баланс пуст — base URL и ключ настроены верно. Пополните и повторите запрос.

Почему Hermes Agent и Gemini 4

На странице приложений Gemini 4 Carbon в OpenRouter Hermes Agent — среди крупнейших именованных пользователей модели, около 43 млрд токенов; на странице Gemini 4 Hydrogen он на третьем месте (данные на 18 ноября 2026 года). Hermes — долгоживущий персональный и CLI-агент с инструментами, памятью и субагентами, то есть именно та работа, под которую Google делала Gemini 4.

Настройка

Если Hermes Agent ещё не установлен, поставьте его официальным скриптом:

bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Затем создайте API-ключ TeamoRouter (он начинается с sk-teamo-).

Вариант 1: мастер настройки. Запустите в терминале, вне чат-сессии:

bash
hermes model
# Выберите "Custom endpoint (self-hosted / VLLM / etc.)"
# API base URL: https://api.teamorouter.com/v1
# API key:      sk-teamo-...
# Model name:   gemini-4-hydrogen

Вариант 2: ~/.hermes/config.yaml. Для Hermes config.yaml — единственный источник настроек модели и эндпоинта:

yaml
model:
  default: gemini-4-hydrogen
  provider: custom
  base_url: https://api.teamorouter.com/v1
  key_env: TEAMOROUTER_API_KEY

а ключ — в ~/.hermes/.env:

bash
TEAMOROUTER_API_KEY=sk-teamo-...

(Можно указать api_key: прямо в config.yaml; key_env нужен, чтобы ключ не лежал в файле конфигурации.)

Переключение моделей в сессии

Внутри чата Hermes команда /model переключает модели на уже настроенных эндпоинтах:

text
/model custom:gemini-4-carbon     # самые сложные задачи
/model custom:gemini-4-hydrogen   # повседневная работа
/model custom:claude-sonnet-5-5   # Claude на том же ключе

Чтобы добавить другого провайдера, выйдите из сессии и снова запустите hermes model. По умолчанию Hermes использует основную модель и для вспомогательных задач (сжатие, распознавание изображений); их можно перевести на более дешёвую модель в настройках Hermes.

Какую Gemini 4 выбрать

Модель Для чего Цена Google, вход / выход за 1M
gemini-4-hydrogen Повседневная агентная работа; самая быстрая и дешёвая Gemini 4 $1,50 / $7,50
gemini-4-carbon Самые сложные задачи $2 / $10 до 30 ноября 2026 года; с 1 декабря $4 / $20
gemini-4-argon Долгие многошаговые задачи с меньшим расходом токенов, чем у Carbon $2 / $10 до 30 ноября 2026 года; с 1 декабря $4 / $20

Токены размышлений считаются выходными. Подробнее — Gemini 4 Hydrogen, Carbon и Argon: что выбрать.

Чем это отличается от нативного эндпоинта Google

У Hermes есть нативный адаптер Gemini, но, согласно его руководству по Gemini, он используется только когда base URL указывает на собственный хост Google (generativelanguage.googleapis.com); прокси на любом другом хосте считается эндпоинтом, совместимым с OpenAI. Поэтому через TeamoRouter Hermes работает с Gemini 4 по Chat Completions:

  • Вызов инструментов и стриминг работают так же, как для любой модели, совместимой с OpenAI.
  • Возможности Interactions API от Google, например long decode на уровне xhigh, не используются, поэтому один ответ укладывается в стандартный лимит вывода (65 536 токенов для Gemini 4).

Оплата

Без подписки: пополняете баланс в консоли от $5, каждый запрос списывается по фактически использованным токенам. Принимаются карты, а также USDT, USDC и ETH. Один баланс работает для Gemini, Claude, GPT и остальных моделей.

Частые вопросы

Поддерживает ли Hermes Agent Gemini 4?

Да. Hermes работает с любым эндпоинтом, реализующим /v1/chat/completions, а TeamoRouter отдаёт на нём gemini-4-hydrogen, gemini-4-carbon и gemini-4-argon.

Нужен ли аккаунт Google или API-ключ Google?

Нет, достаточно ключа TeamoRouter.

Какой base URL указывать?

https://api.teamorouter.com/v1, с provider: custom.

Можно ли с тем же ключом использовать Claude в Hermes?

Да. Переключитесь командой /model custom:claude-sonnet-5-5 или укажите любой другой ID модели TeamoRouter.

Почему ответ не может быть длиннее 65 536 токенов?

Long decode работает через Interactions API от Google, который Hermes использует только на хосте Google. Через эндпоинт, совместимый с OpenAI, действует стандартный лимит вывода.

Похожие статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.