旧版v1接口遗漏group_id会返回401而非参数缺失提示；需通过控制台接口路径确认版本，旧版必须传纯数字group_id，新版仅需api_key认证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
生产环境部署 MiniMax Agent 时，若调用旧版 v1 接口却遗漏 group_id 参数，服务端将返回 401 错误而非明确的参数缺失提示，导致反复重试 API Key 而无法定位真实问题。
确认接口版本与认证方式
登录 MiniMax 开放平台控制台 → 进入「API 密钥」页面 → 查看当前创建的 Key 所属套餐说明或文档示例中的接口路径。若路径含 /v1/text/chatcompletion，即为旧版 v1 接口；若为 /v1/text/chatcompletion_v2，则属新版 v2 接口。新版仅需 api_key 认证，旧版必须传 group_id。
这一步不能跳过。很多团队在灰度切流时混用新旧 SDK，结果线上日志里全是 401，排查三天才发现是某处 config.yaml 还在走 v1 路径。
获取并验证 Group ID
Group ID 不在 API Key 创建页直接显示，需前往「账户设置」→「组织信息」或查阅官方文档中接口调用示例的 query 参数部分。它是一串纯数字，例如 123456789，不是字符串格式，也不带引号。
复制后立即在终端执行 curl 测试：curl -X POST "https://api.minimax.chat/v1/text/chatcompletion?group_id=123456789" -H "Authorization: Bearer sk-xxx" -d '{"model":"abab6.5s-chat"}'。若返回 200，说明 group_id 正确且可路由；若仍为 401，请核对域名是否为当前有效入口（platform.minimax.io 或 platform.minimaxi.com）。
配置方式选择
方法一：环境变量（推荐生产环境）
在部署服务器上编辑 /etc/environment 或容器启动脚本，添加：
export MINIMAX_GROUP_ID="123456789"
export MINIMAX_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
方法二：配置文件注入
若使用 Hermes Agent，在 config.yaml 中显式写入：
minimax:
group_id: 123456789
api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxx
注意：group_id 字段名大小写敏感，必须为小写 group_id，写成 GroupID 或 GROUP_ID 将被忽略。
方法三：代码内硬编码（仅限测试）
不适用于生产。一旦密钥泄露，整个组织凭证体系即遭破坏。
