Перейти к основному содержимому

MiniMax OAuth

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

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

Обзор​

ПараметрЗначение
ID провайдераminimax-oauth
Отображаемое имяMiniMax (OAuth)
Тип аутентификацииБраузерный OAuth (поток PKCE с перенаправлением)
ТранспортСовместимый с Anthropic Messages (anthropic_messages)
МоделиMiniMax-M2.7, MiniMax-M2.7-highspeed
Глобальная конечная точкаhttps://api.minimax.io/anthropic
Китайская конечная точкаhttps://api.minimaxi.com/anthropic
Требуется переменная окруженияНет (MINIMAX_API_KEY не используется для этого провайдера)

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

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

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

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

vibeos

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

Ручной вход​

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

vibeos auth add minimax-oauth

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

Если ваша учётная запись находится на китайской платформе (minimaxi.com), используйте провайдер minimax-cn, основанный на API-ключе — minimax-cn зарегистрирован только с auth_type="api_key" (без OAuth-потока). Настройте MINIMAX_CN_API_KEY (и опционально MINIMAX_CN_BASE_URL) напрямую:

echo 'MINIMAX_CN_API_KEY=ваш-ключ' >> ~/.vibeos/.env

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

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

vibeos auth add minimax-oauth --no-browser

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

Поток OAuth​

VibeOS реализует браузерный OAuth-поток PKCE через конечные точки OAuth MiniMax:

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

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

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

vibeos doctor

Раздел ◆ Auth Providers покажет:

✓ MiniMax OAuth  (выполнен вход, регион=global)

или, если вход не выполнен:

⚠ MiniMax OAuth  (вход не выполнен)

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

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

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

vibeos config set model.default MiniMax-M2.7
vibeos config set model.provider minimax-oauth

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

После входа в ~/.vibeos/config.yaml появятся записи, похожие на:

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

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

ID провайдераПорталКонечная точка вывода
minimax-oauth (глобальный)https://api.minimax.iohttps://api.minimax.io/anthropic
minimax-cn (Китай)https://api.minimaxi.comhttps://api.minimaxi.com/anthropic

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

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

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

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

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

ПеременнаяЭффект
MINIMAX_API_KEYИспользуется только провайдером minimax — игнорируется для minimax-oauth
MINIMAX_CN_API_KEYИспользуется только провайдером minimax-cn — игнорируется для minimax-oauth

Чтобы использовать minimax-oauth в качестве активного провайдера, установите model.provider: minimax-oauth в config.yaml (используйте vibeos setup для пошаговой настройки) или передайте --provider minimax-oauth для однократного вызова:

vibeos --provider minimax-oauth

Модели​

МодельНазначение
MiniMax-M2.7Длинные контексты, сложные вызовы инструментов
MiniMax-M2.7-highspeedНизкая задержка, лёгкие задачи, вспомогательные вызовы

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

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

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

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

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

При фатальной ошибке обновления (HTTP 4xx, invalid_grant, отзыв разрешения и т.д.) VibeOS помечает токен обновления как недействительный и помещает его в карантин локально, чтобы не повторять обречённый обмен. Агент выводит одно сообщение «требуется повторная аутентификация» и не мешает работе, пока вы снова не войдёте.

Решение: снова выполните vibeos auth add minimax-oauth, чтобы начать новый вход. Карантин снимается при следующем успешном обмене.

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

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

Решение: повторно выполните vibeos auth add minimax-oauth (или vibeos model). Поток начнётся заново.

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

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

Решение: повторите вход. Если ошибка повторяется, проверьте, не изменяет ли прокси или перенаправление ответ OAuth.

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

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

vibeos auth add minimax-oauth --no-browser

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

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

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

Решение: выполните vibeos model и выберите MiniMax (OAuth), или выполните vibeos auth add minimax-oauth.

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

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

vibeos auth logout minimax-oauth

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