MiniMax Agent GroupID导致接口401如何办

MiniMax Agent 接口返回401是因GroupID配置错误导致鉴权上下文不匹配：v2接口（/v1/chat/completions）不再接收GroupID，须确保其不出现在URL或请求体中，Authorization头严格为“Bearer + 空格 + API Key”，且域名与控制台权限环境一致（国内用api.minimaxi.com，国际用api.minimax.chat）。

调用 MiniMax Agent 接口时因 GroupID 配置错误返回 401，说明服务端拒绝了身份认证请求——这不是密钥失效，而是鉴权上下文不匹配，必须立刻修正 GroupID 的存在性与传递位置。

确认当前接口版本是否需要 GroupID

新版 v2 兼容接口（/v1/chat/completions）已将组织绑定到 API Key 本身，【GroupID 不再作为 URL 参数或请求体字段传入】。若你在请求 URL 中拼接 ?GroupId=xxx 或在 JSON body 里写"group_id": "xxx"，服务端会直接忽略该字段并因上下文不一致返回 401。

旧版 v1 接口（/v1/text/chatcompletion）才要求 GroupID 必须出现在 query 参数中。现在绝大多数新项目、控制台默认模型列表页展示的模型（如 MiniMax-M2.1、abab6.5-chat）都只支持 v2 路径。

检查 Authorization 头是否被 GroupID 干扰

很多开发者在调试时误把 GroupID 拼进 Authorization 字符串，例如写成 "Bearer sk-xxx&GroupId=yyy" 或 "Bearer sk-xxx?GroupId=yyy" ——这会导致整个 Token 被判定为非法，触发 401 + 1004 错误码。

Authorization 头必须严格为两段式：Bearer 后跟一个半角空格，再紧接原始 API Key 字符串，中间不能插入任何其他符号、参数或连接符。

打印你实际发出的 headers 字典，确认 Authorization 字段值是单行纯文本，且长度为 64 或 32 位（取决于密钥类型），不含 &、?、=、换行或全角空格。

验证 endpoint 域名与 GroupID 权限范围是否一致

第一步：打开 Minimax 控制台 → 「API 密钥管理」→ 点击对应 Key 右侧「查看权限」。

第二步：核对「授权作用域」中是否包含你正在调用的 endpoint 路径，例如 /v1/chat/completions。

第三步：确认你使用的域名与权限绑定的环境一致：【国内版必须用 api.minimaxi.com，国际版必须用 api.minimax.chat】。混用域名会导致服务端无法匹配该 Key 绑定的 GroupID 上下文，哪怕 Key 正确、头格式规范，也会返回 401。

比如你在控制台开通的是国内版服务，却请求 https://api.minimax.chat/v1/chat/completions，服务端根本不会查你的 GroupID 权限，直接拒掉。

用 curl 直连验证 GroupID 是否真被需要

方法一：绕过所有 SDK 和中间件，执行以下命令（替换为你的真实 Key）：

curl -X POST "https://api.minimaxi.com/v1/chat/completions" -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Content-Type: application/json" -d '{"model":"MiniMax-M2.1","messages":[{"role":"user","content":"test"}]}'

如果返回 200，说明 GroupID 根本不该出现；如果仍报 401，请立即检查响应体中的 error.message 字段——它会明确告诉你缺权限还是域名错配。

方法二：故意删掉 Authorization 头重试，若返回 401 但 error.code 是 1004（token is unusable），证明服务端收到了 Token 却无法解析其绑定的组织信息，大概率是域名或 Key 本身未启用对应服务。