group_id 是 MiniMax Agent 接口必需的 URL query 参数，漏传或错误将导致 401 错误；须从控制台「组织管理」中复制以 grp_ 开头的 32 位字符串，并拼接在请求 URL 后，不可置于 header 或 body 中。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用 MiniMax Agent 接口时，group_id 不是可选参数，而是必须显式传入的组织身份标识，漏传或传错将直接触发 401 错误而非 400，排查时极易误判为 API Key 失效。
确认 Group ID 获取路径
登录 platform.minimax.chat 控制台 → 右上角头像 →「账户中心」→ 左侧菜单「组织管理」→ 页面中部找到以 【grp_】 开头的 32 位字符串，即为有效 Group ID。
注意：该 ID 与 API Key 绑定同一组织，不可混用其他账号或测试环境的 Group ID。
Agent 接口请求中传 group_id 的两种方式
MiniMax Agent 接口（/v1/text/chatcompletion）要求 group_id 必须作为 URL query 参数拼接，不接受 header 或 body 传参。
方法一：手动拼接完整 endpoint
在 POST 请求 URL 后追加 ?GroupId=你的-group-id，例如：
POST https://api.minimax.chat/v1/text/chatcompletion?GroupId=grp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
方法二：代码中动态构造 URL
Python 示例：url = f"https://api.minimax.chat/v1/text/chatcompletion?GroupId={os.environ['MINIMAX_GROUP_ID']}"
这一步必须在发起请求前完成，不能靠 SDK 自动注入。
关键配置项校验顺序
第一步：检查 Authorization 请求头是否为 【Bearer + 单个空格 + 完整 API Key】，大小写敏感，Key 中不可含换行或多余空格。
第二步：确认请求 URL 中已包含 ?GroupId= 且值与控制台复制的一致，【不能省略 ? 或写成 &GroupId=】。
第三步：验证请求体 JSON 中是否含 agent_id 字段，且值来自 Agent 列表页「发布后生成的 ID」，不是模型 ID 或项目 ID。
第四步：确保 Content-Type 请求头设为 application/json，否则返回 415 错误，掩盖真实的 group_id 缺失问题。
