본문으로 건너뛰기

MiniMax OAuth

Hermes 에이전트는 MiniMax 포털과 동일한 자격 증명을 사용하여 브라우저 기반 OAuth 로그인 흐름을 통해 MiniMax를 지원합니다. API 키나 신용 카드가 필요하지 않습니다. 한 번 로그인하면 Hermes가 자동으로 세션을 새로 고칩니다.

전송은 anthropic_messages 어댑터(MiniMax는 /anthropic에서 Anthropic Messages 호환 엔드포인트를 노출함)를 재사용하므로 기존의 모든 도구 호출, 스트리밍 및 컨텍스트 기능은 어댑터 변경 없이 작동합니다.

개요​

품목가치
제공자 IDminimax-oauth
표시 이름미니맥스(OAuth)
인증 유형브라우저 OAuth(PKCE 장치 코드 흐름)
운송인류 메시지 호환(anthropic_messages)
모델MiniMax-M2.7, MiniMax-M2.7-highspeed
글로벌 엔드포인트https://api.minimax.io/anthropic
중국 엔드포인트https://api.minimaxi.com/anthropic
환경 변수가 필요합니다아니요(MINIMAX_API_KEY은 이 제공자에 사용되지 않습니다)

전제 조건​

  • 파이썬 3.9+
  • Hermes 에이전트 설치
  • minimax.io(글로벌) 또는 minimaxi.com(중국)의 MiniMax 계정
  • 로컬 시스템에서 사용 가능한 브라우저(또는 원격 세션의 경우 --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)에 있는 경우 대신 중국 지역 OAuth 제공자 ID minimax-cn을 사용하거나 OAuth를 건너뛰고 MINIMAX_CN_API_KEY / MINIMAX_CN_BASE_URL을 직접 구성하세요. 이전 문서에 설명된 --region cn 플래그는 CLI의 인수 구문 분석기를 통해 연결되지 않습니다. 대신 minimax-cn 제공자를 사용하세요.

hermes auth add minimax-cn --type oauth   # if OAuth is supported on your CN account
# or simpler:
echo 'MINIMAX_CN_API_KEY=your-key' >> ~/.hermes/.env

원격/헤드리스 세션​

브라우저를 사용할 수 없는 서버 또는 컨테이너의 경우:

hermes auth add minimax-oauth --no-browser

Hermes는 확인 URL과 사용자 코드를 인쇄합니다. 아무 기기에서나 URL을 열고 메시지가 나타나면 코드를 입력하세요.

OAuth 흐름​

Hermes는 MiniMax OAuth 엔드포인트에 대해 PKCE 장치 코드 흐름을 구현합니다.

  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, 만료)은 minimax-oauth 키 아래의 ~/.hermes/auth.json에 저장됩니다.

토큰 새로 고침(표준 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

지역 엔드포인트​

제공자 ID포털추론 끝점
minimax-oauth(글로벌)https://api.minimax.iohttps://api.minimax.io/anthropic
minimax-cn(중국)https://api.minimaxi.comhttps://api.minimaxi.com/anthropic

제공자 별칭​

다음은 모두 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을 사용하지 않습니다. 이러한 변수는 API 키 기반 minimax 및 minimax-cn 제공자 전용입니다.

변수효과
MINIMAX_API_KEYminimax 제공자에서만 사용되며 minimax-oauth에서는 무시됩니다.
MINIMAX_CN_API_KEYminimax-cn 제공자에서만 사용되며 minimax-oauth에서는 무시됩니다.

런타임에 minimax-oauth 제공자를 강제하려면 다음을 수행하세요.

HERMES_INFERENCE_PROVIDER=minimax-oauth hermes

모델​

모델다음에 가장 적합
MiniMax-M2.7긴 상황 추론, 복잡한 도구 호출
MiniMax-M2.7-highspeed낮은 대기 시간, 가벼운 작업, 보조 통화

두 모델 모두 최대 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

참조​