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/text/chatcompletionGroupId=xxx，说明默认使用旧版 v1 接口。
• 如果示例中的 endpoint 是 /v1/chat/completions 或 /v1/text/chatcompletion_v2，且 URL 里没有 GroupId，则属于新版 v2 接口。

不要凭记忆或旧文档判断。应以控制台实时生成的示例为准。

旧版 v1 接口：GroupID 必须放在 URL query 参数中

方法一：手动拼接 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/chatcompletionGroupId=a1b2c3d4e5f67890；
• 第三步：按正确位置传参
  发起请求时，不能 把 GroupID 放进 Authorization header 或 JSON body，只允许出现在 URL query 中；否则服务端会忽略，仍返回 401。

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

新版 v2 接口包括 /v1/chat/completions 和 /v1/text/chatcompletion_v2。

这类接口已经把组织绑定关系直接写进了 Bearer Token。只要使用的是在 MiniMax 控制台生成的有效 API 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，排查方向也会因此跑偏。

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

下载APP查看