MiniMax OAuth

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

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

개요

품목	가치
제공자 ID	minimax-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+
• 헤르메스 에이전트 설치
• 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)

## 스위칭 모델 \{#switching-models}

```bash
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.io	https://api.minimax.io/anthropic
minimax-cn(중국)	https://api.minimaxi.com	https://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_KEY	minimax 공급자에서만 사용되며 minimax-oauth에서는 무시됩니다.
MINIMAX_CN_API_KEY	minimax-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

참조

• AI 공급자 참조
• 환경변수
• 구성
• 헤르메스 닥터