新版Agent接口无需传GroupID，鉴权由Bearer Token绑定的组织身份决定；GroupID在后台硬性约束模型权限，若模型未在组织白名单中开通则返回1039。

调用 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 已获授权。

若显示「申请开通」，需联系管理员在「组织设置→模型管理」中手动勾选。

《夸克》非常好用的免费AI浏览器

下载APP查看