minimax agent 接口调用时groupid传参方式依版本而异：v1接口须将16位groupid作为query参数拼在url末尾，否则返回401；v2接口已内置于bearer token中，传入则报1004错误；agent专用接口无需groupid，但json body中必须包含已发布的agent_id字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用 MiniMax Agent 接口时，GroupID 传参方式取决于你使用的接口版本——新版 v2 接口已取消 URL 中传 GroupID 的要求，而旧版 v1 接口必须将其拼在 query 参数里，填错或漏填直接返回 401 错误，且不会提示“缺少 GroupID”，容易误判为 API Key 失效。
确认你用的是哪个接口版本
打开 MiniMax 控制台 → 进入「Agent」页面 → 点击你要调用的 Agent → 查看右侧「调用示例」代码块。如果示例中 endpoint 是 /v1/text/chatcompletion?GroupId=xxx，说明它默认指向旧版 v1 接口；如果示例中 endpoint 是 /v1/chat/completions 或 /v1/text/chatcompletion_v2，且没有 GroupId 出现在 URL 里，则属于新版 v2 接口。不要凭记忆或旧文档判断，以控制台实时生成的示例为准。
旧版 v1 接口：GroupID 必须作为 query 参数拼在 URL 末尾
方法一：手动拼接 URL
第一步：获取 GroupID —— 登录 platform.minimax.chat → 左侧「组织管理」→ 复制「Group ID」字段（16位十六进制字符串，如 【a1b2c3d4e5f67890】）；
第二步：构造完整 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，排查方向完全跑偏。
