必须在旧版minimax api调用中传入正确的group id,否则返回401错误;group id格式为“grp_”开头的32位字母数字字符串,需通过环境变量、显式参数或url拼接方式注入,并在控制台验证其有效性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要把从MiniMax控制台复制出来的Group ID用在代码里调用Agent服务,否则请求会直接被拒绝返回401错误——这个ID不是可选参数,而是旧版API的硬性要求,漏填或填错格式都会让整个调用链中断。
确认Group ID是否有效
打开MiniMax开发者控制台,进入「组织管理」页面,找到显示为【grp_开头的32位字符串】的字段,这就是你的Group ID。它必须以“grp_”起始,后面紧跟32个字母数字组合;如果看到的是“acc_”或纯数字,说明你复制错了Account ID,得重新找。
旧版接口(如/v1/text/chatcompletion)强制要求该ID作为query参数传入,新版v2接口虽通常不需,但若你正在对接历史项目或使用LangChain等封装库,仍可能默认启用旧协议——别凭经验跳过验证。
在Python代码中安全注入Group ID
方法一:通过环境变量加载(推荐)
在系统终端执行:export MINIMAX_GROUP_ID="grp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",然后在Python脚本中用os.environ.get("MINIMAX_GROUP_ID")读取。这样避免密钥硬编码进源码,也方便多环境切换。
方法二:显式传参初始化模型
如果你用的是LangChain的MinimaxLLM类,必须在初始化时明确指定group_id参数:llm = MinimaxLLM(model="abab6-chat", api_key=API_KEY, group_id=GROUP_ID)。漏掉group_id字段,即使API Key正确,也会触发401认证失败。
为 AI 代理注册和管理 ICANN 域名,支持钱包认证(SIWE/SIWS),可在 Base 或 Solana 上使用 USDC 支付,提供完整 DNS 管理。
方法三:拼接HTTP请求URL
对旧版接口,需手动把Group ID加到请求地址末尾:url = f"https://api.minimax.chat/v1/text/chatcompletion?group_id={GROUP_ID}"。注意这里不能用空格或换行,也不能URL编码,直接原样拼接即可。
验证调用是否生效
第一步:构造一个最简测试请求,只包含必要字段——
POST https://api.minimax.chat/v1/text/chatcompletion?group_id=grp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Header: Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Body: {"model": "abab6-chat", "messages": [{"role":"user","content":"你好"}]}
第二步:发送后检查响应状态码。返回200且有content字段,说明Group ID已识别成功;若仍是401,立刻回头核对三点:【是否复制了完整的grp_前缀】、是否用了旧版接口路径、API Key是否对应同一组织下的密钥。
第三步:在MiniMax控制台「API调用监控」页查看实时日志,找到刚发起的请求记录,确认其中group_id参数值与你复制的一致。日志里显示“group_id missing”或“invalid format”,就说明前两步出错了。










