跳到主要內容

MiniMax OAuth

Hermes Agent 通過基於瀏覽器的 OAuth 登錄流程支持 MiniMax，使用與 MiniMax 門戶 相同的憑據。無需 API 密鑰或信用卡——只需登錄一次，Hermes 就會自動刷新您的會話。

該傳輸層複用 anthropic_messages 適配器（MiniMax 在 /anthropic 處公開了一個兼容 Anthropic Messages 的端點），因此所有現有的工具調用、流式傳輸和上下文功能無需任何適配器更改即可正常工作。

概覽​

項目值
Provider IDminimax-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
需要環境變量否（此 provider 不使用 MINIMAX_API_KEY）

前提條件​

  • Python 3.9+
  • 已安裝 Hermes Agent
  • 擁有 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)，請改用基於 API 密鑰的 minimax-cn provider——minimax-cn 僅註冊為 auth_type="api_key"（無 OAuth 流程）。直接配置 MINIMAX_CN_API_KEY（以及可選的 MINIMAX_CN_BASE_URL）：

echo 'MINIMAX_CN_API_KEY=your-key' >> ~/.hermes/.env

遠程/無頭會話​

在沒有瀏覽器的服務器或容器上：

hermes auth add minimax-oauth --no-browser

Hermes 將打印驗證 URL 和用戶代碼——在任何設備上打開該 URL 並在提示時輸入代碼。

OAuth 流程​

Hermes 針對 MiniMax OAuth 端點實現 PKCE 瀏覽器 OAuth 流程：

  1. Hermes 生成 PKCE verifier/challenge 對和一個隨機 state 值。
  2. 它將 challenge POST 到 {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.default MiniMax-M2.7
hermes config set model.provider minimax-oauth

配置參考​

登錄後，~/.hermes/config.yaml 將包含類似以下條目：

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

區域端點​

Provider id門戶推理端點
minimax-oauth (全球)https://api.minimax.iohttps://api.minimax.io/anthropic
minimax-cn (中國)https://api.minimaxi.comhttps://api.minimaxi.com/anthropic

Provider 別名​

以下所有名稱均解析為 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 provider 不使用 MINIMAX_API_KEY 或 MINIMAX_BASE_URL。這些變量僅用於基於 API 密鑰的 minimax 和 minimax-cn providers。

變量效果
MINIMAX_API_KEY僅由 minimax provider 使用——對 minimax-oauth 忽略
MINIMAX_CN_API_KEY僅由 minimax-cn provider 使用——對 minimax-oauth 忽略

要將 minimax-oauth 用作活動 provider，請在 config.yaml 中設置 model.provider: minimax-oauth（使用 hermes setup 進行引導式流程），或在單次調用時傳遞 --provider minimax-oauth：

hermes --provider minimax-oauth

模型​

模型最佳用途
MiniMax-M2.7長上下文推理、複雜工具調用
MiniMax-M2.7-highspeed低延遲、輕量級任務、輔助調用

兩種模型均支持高達 200,000 個 token 的上下文。

當 minimax-oauth 為主要 provider 時，MiniMax-M2.7-highspeed 也會自動用作視覺和委託任務的輔助模型。

故障排除​

令牌過期——未自動重新登錄​

如果令牌距離過期不足 60 秒，Hermes 會在每次會話開始時刷新令牌。如果訪問令牌已經過期（例如，在長時間離線後），刷新將在下一個請求時自動發生。如果刷新因 refresh_token_reused 或 invalid_grant 失敗，Hermes 將會話標記為需要重新登錄。

當刷新失敗為終止性錯誤（HTTP 4xx、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

另請參閱​