MiniMax Agent GroupID接口传参方法

MiniMax Agent 接口调用时GroupID传参方式依版本而异：v1接口须将16位GroupID作为query参数拼在URL末尾，否则返回401；v2接口已内置于Bearer Token中，传入则报1004错误；Agent专用接口无需GroupID，但JSON body中必须包含已发布的agent_id字段。

在调用 MiniMax Agent 接口时，GroupID 到底怎么传，关键要看你用的是哪个版本的接口。新版 v2 已经不再要求把 GroupID 放进 URL 里；但如果还是旧版 v1，就必须把它拼到 query 参数中。这个地方特别容易踩坑：一旦填错或者漏填，接口会直接返回 401，而且不会明确提示“缺少 GroupID”，很多人第一反应往往是误以为 API Key 已经过期或失效。

确认你用的是哪个接口版本

打开 MiniMax 控制台 → 进入「Agent」页面 → 点击你要调用的 Agent → 查看右侧「调用示例」代码块。如果示例中 endpoint 是

，说明它默认指向旧版 v1 接口；如果示例中 endpoint 是 或 ，且没有 GroupId 出现在 URL 里，则属于新版 v2 接口。不要凭记忆或旧文档判断，以控制台实时生成的示例为准。

旧版 v1 接口：GroupID 必须作为 query 参数拼在 URL 末尾

方法一：手动拼接 URL

第一步：获取 GroupID —— 登录 platform.minimax.chat → 左侧「组织管理」→ 复制「Group ID」字段（16位十六进制字符串，如

）；

第二步：构造完整 endpoint —— 在基础路径 https://api.minimax.chat/v1/text/chatcompletion 后追加 ?GroupId=你的GroupID，例如：https://api.minimax.chat/v1/text/chatcompletion?GroupId=a1b2c3d4e5f67890；

第三步：发起请求时，

把 GroupID 放进 Authorization header 或 JSON body，只允许出现在 URL query 中；否则服务端会忽略，仍返回 401。

新版 v2 接口：GroupID 不再需要传参

新版 v2 接口（包括 /v1/chat/completions 和 /v1/text/chatcompletion_v2）已经把组织绑定关系直接写进了 Bearer Token。也就是说，只要使用的是在 MiniMax 控制台生成的有效 API Key，这个 Key 就会自动关联到对应的 Group，既不需要再额外传 GroupID，也不建议继续传递。

这一步操作起来很简单，直接把旧版 URL 中的 ?GroupId=xxx 全部删掉就行。如果保留，请求会失败并返回 1004 错误。

注意：如果你正在用 OpenAI SDK 兼容模式接入，base_url 应设为 https://api.minimax.chat/v1，后续 endpoint 自动补全为 /chat/completions，此时

手动往 base_url 里塞 GroupId。

Agent 专用接口：GroupID 不参与传参，但 agent_id 必须存在

调用 Agent 类接口（如 /v1/text/chatcompletion 且 body 中含 "agent_id": "xxx"）时，GroupID 依然不出现于任何位置。真正起作用的是 agent_id 字段本身 —— 它已在后台与所属 Group 绑定。只要 agent_id 正确且对应 Agent 已发布，系统自动识别归属组织。

这一步最容易踩的坑是：误以为 agent_id 可替代 GroupID，于是删掉 URL 中的 GroupId 却忘了在 JSON body 里填 agent_id。结果报 404 而非 401，排查方向完全跑偏。