词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"MiniMax OAuth"
MiniMax OAuth
anthropic_messages 适配器（MiniMax 在 /anthropic 路径暴露了一个兼容 Anthropic Messages 的端点），因此所有现有的工具调用、流式传输和上下文功能无需任何适配器改动即可正常使用。概览
| 项目 | 值 |
|---|---|
| Provider 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 不用于此 provider） |
前提条件
--no-browser）快速开始
~/.hermes/auth.json 下，并在每次会话前自动刷新。手动登录
中国区域
minimaxi.com），请改用中国区域 OAuth provider id minimax-cn，或跳过 OAuth 直接配置 MINIMAX_CN_API_KEY / MINIMAX_CN_BASE_URL。旧版文档中描述的 --region cn 标志未接入 CLI 的参数解析器；请改用 minimax-cn provider：远程/无头会话
OAuth 流程
1.
2.
{base_url}/oauth/code 发送 POST 请求，获取 user_code 和 verification_uri。3.
verification_uri。如有提示，输入 user_code。4.
{base_url}/oauth/token，直到令牌到达（或超过截止时间）。5.
access_token、refresh_token、过期时间）以 minimax-oauth 为键保存到 ~/.hermes/auth.json。refresh_token 授权）在每次会话启动时自动执行，当 access token 距过期不足 60 秒时触发。检查登录状态
◆ Auth Providers 部分将显示：✓ MiniMax OAuth (logged in, region=global)⚠ MiniMax OAuth (not logged in)切换模型
配置参考
~/.hermes/config.yaml 将包含类似如下的条目：区域端点
| Provider id | 门户 | 推理端点 |
|---|---|---|
minimax-oauth（全球） | https://api.minimax.io | https://api.minimax.io/anthropic |
minimax-cn（中国） | https://api.minimaxi.com | https://api.minimaxi.com/anthropic |
Provider 别名
minimax-oauth：环境变量
minimax-oauth provider 不使用 MINIMAX_API_KEY 或 MINIMAX_BASE_URL。这些变量仅用于基于 API 密钥的 minimax 和 minimax-cn provider。| 变量 | 作用 |
|---|---|
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：模型
| 模型 | 最适合 |
|---|---|
MiniMax-M2.7 | 长上下文推理、复杂工具调用 |
MiniMax-M2.7-highspeed | 低延迟、轻量任务、辅助调用 |
minimax-oauth 为主 provider 时，MiniMax-M2.7-highspeed 也会自动用作视觉和委托任务的辅助模型。故障排查
令牌已过期——未自动重新登录
refresh_token_reused 或 invalid_grant，Hermes 会将会话标记为需要重新登录。invalid_grant、授权已撤销等）时，Hermes 将 refresh token 标记为失效并在本地隔离，避免持续重放注定失败的交换。Agent 会显示一条"需要重新认证"的消息，并在您再次登录之 前保持等待。hermes auth add minimax-oauth 以开始全新登录。下一次成功交换后隔离状态将自动清除。授权超时
hermes auth add minimax-oauth（或 hermes model）。流程将重新开始。State 不匹配（可能的 CSRF）
state 值与其发送的值不匹配。从远程服务器登录
hermes 无法打开浏览器窗口，请使用 --no-browser：运行时出现"未登录 MiniMax OAuth"错误
minimax-oauth 的凭据。您尚未登录，或凭据文件已被删除。hermes model 并选择 MiniMax (OAuth)，或运行 hermes auth add minimax-oauth。退出登录
另请参阅
修改于 2026-05-31 00:25:01