MiniMax Agent 鉴权失败主因是接口版本与 GroupID 传参方式不匹配：旧版 v1（/v1/text/chatcompletion）必须将 GroupId 作为 URL query 参数（?GroupId=xxx），新版 v2（/v1/chat/completions）则完全无需传 GroupId，仅依赖 Bearer Token。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent 调用时提示鉴权失败，但 API Key 明明有效、Authorization 头也写对了，问题却卡在 GroupID 上——这种情况几乎全是旧版接口未传 GroupID 或传错位置导致的，401 错误会伪装成密钥失效，实际根本没走到密钥校验环节。
先确认你用的是哪个接口版本
这一步决定后续所有操作方向。MiniMax 目前并存两套 Chat 接口：旧版 v1（/v1/text/chatcompletion）强制要求 GroupID 作为 URL query 参数；新版 v2 兼容接口（/v1/chat/completions）则完全不需要 GroupID，Bearer Token 已绑定组织上下文。
打开 MiniMax 控制台 → 进入「模型广场」或「API 文档」页，找到你正在调用的模型（如 abab6.5s、minimax-m2.7），查看其推荐 endpoint 路径。路径含 /text/chatcompletion 且无 _v2 后缀 → 旧版；路径为 /v1/chat/completions 或 /text/chatcompletion_v2 → 新版。
⚠️ 注意：【不要凭记忆或旧项目代码判断版本】，必须以当前控制台文档显示的 endpoint 为准。历史项目里抄来的路径可能已废弃。
旧版接口：GroupID 必须拼在 URL 里
方法一：手动构造完整请求 URL
将 GroupID 作为 query 参数附加在 endpoint 末尾，格式严格为 ?GroupId=123456789（注意 G 大写，Id 首字母大写，无空格、无引号、无中文字符）。
例如完整 URL 应为：https://api.minimax.chat/v1/text/chatcompletion?GroupId=123456789。
方法二：用 SDK 传参（以 Python OpenAI 兼容层为例）
若使用 LangChain 或自封装 client，需显式在 base_url 后拼接 GroupId，不能只靠 headers 传。比如：
client = OpenAI(base_url="https://api.minimax.chat/v1/text/chatcompletion?GroupId=123456789", api_key="sk-xxx")
这一步容易踩坑：很多 OpenAI 兼容 SDK 默认只处理 headers，不会自动注入 query 参数，必须手动塞进 base_url 字符串里。
新版接口：GroupID 不传才是正确姿势
第一步：删掉所有 URL 中的 GroupId 参数
把 https://api.minimax.chat/v1/chat/completions?GroupId=123456789 改成 https://api.minimax.chat/v1/chat/completions，确保 URL 干净无 query。
第二步：检查 Authorization 头是否纯净
新版接口仅依赖 Bearer Token 鉴权，GroupID 已通过密钥绑定。此时若 headers 里还带 GroupId，服务端会忽略它；但若 URL 里残留 GroupId，某些网关可能误判为旧版路由而触发 401。
第三步：验证密钥来源域名与 endpoint 域名一致
从 platform.minimax.chat 生成的密钥，只能用于 api.minimax.chat；从 platform.minimaxi.com 生成的密钥，必须配 api.minimaxi.com。混用直接返回 401，和 GroupID 无关，但现象高度相似。
快速验证工具链是否干扰
绕过 SDK 和 Agent 框架，用 curl 直连测试：
旧版接口验证命令：curl -X POST "https://api.minimax.chat/v1/text/chatcompletion?GroupId=123456789" -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"abab6.5s","messages":[{"role":"user","content":"hello"}]}'
新版接口验证命令：curl -X POST "https://api.minimax.chat/v1/chat/completions" -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"minimax-m2.7","messages":[{"role":"user","content":"hello"}]}'
只要 curl 成功，说明问题出在 SDK 封装或 Agent 配置层；如果 curl 也报 401，说明密钥、域名或 endpoint 根本不匹配。
