МиниМакс OAuth

Агент Hermes поддерживает MiniMax через браузерный вход OAuth, используя те же учетные данные, что и для портала MiniMax. Никакого API-ключа или кредитной карты не требуется — войдите один раз, и Hermes автоматически обновит вашу сессию.

Транспорт использует адаптер anthropic_messages (MiniMax обеспечивает совместимость с Anthropic Messages конечную точку /anthropic), поэтому все дополнительные функции вызова инструментов, потоковой передачи и контекста работают без изменений адаптера.

Обзор

Предварительные требования

• Питон 3.9+
• Установленный Агент Гермес
• Учетная запись MiniMax на minimax.io (гальный лоб) или minimaxi.com (Китай)
• Браузер на локальной машине (или викор --no-browser для удаленных сессий)

Быстрый старт

# Запустить выбор провайдера и модели
hermes model
# → Выберите "MiniMax (OAuth)" из списка провайдеров
# → Hermes откроет ваш браузер на странице авторизации MiniMax
# → Подтвердите доступ в браузере
# → Выберите модель (MiniMax-M2.7 или MiniMax-M2.7-highspeed)
# → Начните общение

hermes

После первого входа учетные данные сохраняются в ~/.hermes/auth.json и автоматически обновляются перед каждой сессией.

Вход вручную

Вы можете активировать вход, не проходя через выбранные модели:

hermes auth add minimax-oauth

Регион Китай

Если ваша учетная запись находится на глобальной платформе (minimaxi.com), подтвердите идентификатор провайдера OAuth для региона Китая minimax-cn вместо глобального или пропустите OAuth и настройте MINIMAX_CN_API_KEY / MINIMAX_CN_BASE_URL напрямую. Флаг --region cn, описанный в официальной документации, не подключен через парсер аргументов CLI; провайдер minimax-cn:

hermes auth add minimax-cn --type oauth   # если OAuth поддерживается для вашей китайской учетной записи
# или проще:
echo 'MINIMAX_CN_API_KEY=your-key' >> ~/.hermes/.env

Удалённые / безголовые сессии

На серверах или в контейнерах, где нет браузера:

hermes auth add minimax-oauth --no-browser

Hermes выведете URL-адрес для проверки и код пользователя — URL-адрес входа на любое устройство и введите код, когда будет предложено.

Процесс OAuth

Hermes реализует потоковый код устройства PKCE с использованием конечных точек OAuth MiniMax:

1. Гермес постоянно включает верификатор/вызов PKCE и случайное состояние.
2. Он отправляет POST-запрос на {base_url}/oauth/code с вызовом и получает user_code и verification_uri.
3. Ваш браузер предоставляет verification_uri. Если будет предложено, введите user_code.
4. Гермес запрашивает {base_url}/oauth/token, пока не получит токен (или не истечет время).
5. Токены (access_token, refresh_token, срок) определения в ~/.hermes/auth.json под ключом minimax-oauth.

Обновление токена (стандартный грант OAuth refresh_token) производится автоматически при каждом запуске сессии, если до истечения срока действия access_token осталось менее 60 секунд.

проверка разрешения

hermes doctor

Раздел ◆ Поставщики аутентификации покажет:

✓ MiniMax OAuth  (logged in, region=global)

или, если не принимать во внимание:

⚠ MiniMax OAuth  (not logged in)

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

hermes model
# → Выберите "MiniMax (OAuth)"
# → Выберите из списка моделей

Или установите модель напрямую:

hermes config set model MiniMax-M2.7
hermes config set provider minimax-oauth

Справочник по конфигурации

После ввода ~/.hermes/config.yaml будут сохранены записи, похожие на:

model:
  default: MiniMax-M2.7
  provider: minimax-oauth
  base_url: https://api.minimax.io/anthropic

Региональные конечные точки

Псевдонимы провайдера

В minimax-oauth разрешены все следующие варианты:

hermes --provider minimax-oauth    # канонический
hermes --provider minimax-portal   # псевдоним
hermes --provider minimax-global   # псевдоним
hermes --provider minimax_oauth    # псевдоним (форма с подчеркиванием)

Переменные окружения

Провайдер minimax-oauth не использует MINIMAX_API_KEY или MINIMAX_BASE_URL. Эти переменные результаты выводятся только для провайдеров на основе API-переключений minimax и minimax-cn.

Чтобы использовать использование провайдера minimax-oauth во время выполнения:

HERMES_INFERENCE_PROVIDER=minimax-oauth hermes

Модели

Обе модели применяются до 200 000 токенов контекста.

«MiniMax-M2.7-highspeed» также автоматически используется в качестве вспомогательной модели для решения задач и делегирования, когда «minimax-oauth» является основным провайдером.

Устранение неполадок

Срок действия действия истек — автоматический повторный вход не показал результата

Hermes обновляет токен при каждом запуске сессии, если до истечения срока действия осталось менее 60 секунд. Если access_token уже истек (например, после длительного периода пребывания в сети), обновление происходит автоматически при следующем запросе. Если обновление не происходит из-за ошибки refresh_token_reused или invalid_grant, Hermes помечает сессию как требующий повторного входа.

Исправление: снова выполните hermes auth add minimax-oauth, чтобы начать новый вход.

Время авторизации истекло

Поток кода устройства имеет ограниченное окно действия. Если вы не подтвердите время входа, Гермес выполнит ошибку тайм-аута.

Исправление: повторно выполните hermes auth add minimax-oauth (или hermes model). Процесс начать заново.

Несоответствие состояния (возможная CSRF)

Компания Hermes обнаружила, что значение государство, возвращенное сервером авторизации, не соответствует отправленному.

Исправление: повторите вход. Если проблема сохраняется, проверьте наличие прокси или перенаправления, изменяющего ответ OAuth.

Вход с удаленного сервера

Если «hermes» не может открыть окно браузера, воспользуйтесь «--no-browser»:

hermes auth add minimax-oauth --no-browser

Hermes выведет URL-адрес и код. Откройте URL-адрес на любом устройстве и завершите процесс там.

Ошибка «Не выполнен вход в MiniMax OAuth» во время выполнения

В базе аутентификации нет учетных данных для minimax-oauth. Вы все еще не зарегистрированы, или файл с учетными данными был удален.

Исправление: выполните hermes model и выберите MiniMax (OAuth) или выполните hermes auth add minimax-oauth.

Выход из системы

Чтобы удалить сохраненные учетные данные MiniMax OAuth:

hermes auth remove minimax-oauth

См. также

• Справочник по AI-провайдерам
• Переменные окружения
• Конфигурация
• доктор Гермес