sidebar_position: 15 title: "MiniMax OAuth" description: "Log into MiniMax via browser OAuth and use MiniMax-M2.7 models in Hermes Agent — no API key required" lang: ru

МиниМакс OAuth

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

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

Обзор

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

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

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

# Launch the provider and model picker
hermes model
# → Select "MiniMax (OAuth)" from the provider list
# → Hermes opens your browser to the MiniMax authorization page
# → Approve access in the browser
# → Select a model (MiniMax-M2.7 or MiniMax-M2.7-highspeed)
# → Start chatting

hermes

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

Вход в систему вручную

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

hermes auth add minimax-oauth

Китайский регион

Если ваша учетная запись находится на китайской платформе (minimaxi.com), введите --region cn:

hermes auth add minimax-oauth --region cn

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

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

hermes auth add minimax-oauth --no-browser

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

Процесс OAuth

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

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

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

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

hermes doctor

В разделе ◆ Auth Providers будет показано:

✓ MiniMax OAuth  (logged in, region=global)

или, если вы не вошли в систему:

⚠ MiniMax OAuth  (not logged in)

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

hermes model
# → Select "MiniMax (OAuth)"
# → Pick from the model list

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

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

--region флаг

Псевдонимы поставщиков

Все следующее приводит к minimax-oauth:

hermes --provider minimax-oauth    # canonical
hermes --provider minimax-portal   # alias
hermes --provider minimax-global   # alias
hermes --provider minimax_oauth    # alias (underscore form)

Переменные среды

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

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

HERMES_INFERENCE_PROVIDER=minimax-oauth hermes

Модели

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

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

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

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

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

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

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

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

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

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

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

Исправление: повторите вход в систему. Если проблема сохраняется, проверьте наличие прокси-сервера или перенаправления, изменяющего ответ 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

См. также

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