必须在旧版v1接口url中正确传入group id，否则调用agent会返回401错误；group id需从控制台组织管理页、应用详情页或api密钥示例中获取，并严格匹配大小写与格式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 MiniMax 控制台创建并调用 Agent 实例，必须正确配置 Group ID，否则请求会直接返回 401 错误，且不会提示缺失参数——你可能反复重试 API Key，却始终卡在这一步。
确认当前接口版本与 Group ID 是否必需
MiniMax 当前存在两套并行的 Agent 调用路径：旧版 v1 接口（/v1/text/chatcompletion）要求 group_id 必须作为 URL query 参数传入；新版 v2 兼容接口（/v1/chat/completions）则完全不接受 group_id，其权限已绑定在 Bearer Token 中。若你正在调用 Agent（如通过 agent_id 字段），实际走的是旧版路径，必须传 group_id，否则 401 不可绕过。
验证方式：打开控制台 Agent 列表页，点击任意已发布的 Agent 的「调试」按钮，观察浏览器地址栏中发起请求的 URL——如果末尾带 ?GroupId=xxx，就是旧版；如果纯路径为 /v1/text/chatcompletion，则仍属旧版体系，group_id 不可省略。
获取 Group ID 的三种可靠方式
方法一：从控制台「组织管理」页直接复制
登录 platform.minimax.io → 右上角头像 → 「账户中心」→ 左侧菜单「组织管理」→ 页面中部找到「Group ID」字段，它是一串以 grp_ 开头、共32位的十六进制字符串，全选复制。
方法二：从应用详情页提取
进入「应用管理」→ 点击任一已创建应用 → 在「API 凭证」区块中，除 API Key 外，下方明确标注「Group ID」，此处值与组织管理页一致，可交叉核对。
方法三：通过 API 密钥页面的示例请求反推
进入「接口密钥」页 → 找到某条密钥右侧的「查看示例」按钮 → 展开后，在 curl 示例的 URL 中定位 ?GroupId= 后面的值，该值即为当前 Key 绑定的 Group ID。
在 Agent 调用请求中注入 Group ID
第一步：构造完整 endpoint URL
使用旧版 Agent 接口路径：https://api.minimax.chat/v1/text/chatcompletion?GroupId=【你的32位grp_xxx字符串】
第二步：设置请求头
Authorization: Bearer your_api_key_here
Content-Type: application/json
第三步：提交 JSON Body
确保包含 agent_id（从控制台 Agent 列表页复制）、messages 数组，且不能遗漏 model 字段（如 abab6.5s-chat）。注意：model 值必须与该 Group ID 下已启用的模型完全一致，大小写和连字符均不可错，否则返回 1004 错误。
第四步：验证响应结构
成功返回时，JSON 中 choices[0].message.content 应为文本回复；若返回 { "code": 401, "message": "Authentication failed" }，请立即检查 GroupId 是否拼写错误、是否多空格、是否误用了新版 base_url 路径。
