新版Agent接口无需传GroupID，鉴权由Bearer Token绑定的组织身份决定；GroupID在后台硬性约束模型权限，若模型未在组织白名单中开通则返回1039。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用 MiniMax Agent 接口时，GroupID 是否需要传、怎么传、和模型权限是否挂钩，直接决定请求是 200 还是 401/1004。错把旧版 GroupID 规则套到新版 Agent 接口上，哪怕 API Key 正确也会被拒。
Agent 接口是否需要 GroupID
新版 Agent 接口（路径以 /v1/agents/ 开头）【不需要在 URL 或 body 中显式传 GroupID】。鉴权完全由 Bearer Token 绑定的组织身份决定——这个 Token 在控制台生成时已自动关联所属 group，后续所有请求都默认走该 group 的配额与模型白名单。
旧版接口（如 /v1/text/chatcompletion）必须拼 ?GroupId=123456，但 Agent 不属于该体系。
GroupID 和模型调用权限的关系
GroupID 本身不参与请求传输，但它在后台起硬性约束作用：
第一步：登录 platform.minimax.chat → 进「Agent 管理」页面 → 查看当前 Agent 列表右侧的「所属组织」列；
第二步：点击 Agent 名称进入详情页 → 滚动到底部「模型权限」区域；
第三步：确认列表中勾选的模型 ID（如 minimax-m2.7）状态为「已开通」且未灰显；
【若模型显示「未授权」或空白，即使 GroupID 正确、API Key 有效，调用也会返回 1039（model_not_found）】。这不是网络或参数问题，而是组织级模型授权未生效。
验证 GroupID 关联是否生效的实操方法
方法一：用 curl 直接测基础权限
curl -X GET "https://api.minimax.chat/v1/agents" -H "Authorization: Bearer YOUR_API_KEY"
成功返回 JSON 列表即说明 Token 已正确绑定 group；若返回 401，则 Key 无效或过期。
方法二：查 Agent 对应的 model_id 是否在组织白名单里
登录控制台 → 「模型广场」→ 切换顶部「我的组织」标签 → 搜索你要调用的模型（如 minimax-m2.1）→ 若右侧显示「已开通」，说明该 group 已获授权；若显示「申请开通」，需联系管理员在「组织设置→模型管理」中手动勾选。
