调用 minimax agent api 时填错 groupid 会导致 401 或 1004 报错，因平台 agent 接口必须传正确 groupid（从 agent.minimax.io 复制，形如 grp_8a9b3c4d5e6f7g8h），而模型级 agent 模式（如 tools 调用）完全不依赖 groupid，url 中携带会触发 400 错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用 MiniMax Agent API 时填错 GroupID 会导致 401 或 1004 报错，但错误信息不提示具体原因，容易误判为 API Key 无效。
先确认你用的是哪类 Agent 接口
MiniMax 当前存在两类 Agent 相关能力：一类是平台侧的「智能体（Agent）」可视化编排服务，另一类是模型侧的「Agent 模式调用」（如 abab6.5s 的 tool calling 能力）。前者必须传 GroupID，后者完全不依赖 GroupID。
如果你在 agent.minimax.io 创建过智能体、配置过工作流、导出过 agent_id，那你调用的是平台 Agent 接口；如果你只是在 chat/completions 请求里加了 tools 字段让模型自己调工具，那根本不需要 GroupID。
平台 Agent 接口：GroupID 必须从控制台复制，不能手写或猜测
第一步：登录 agent.minimax.io（不是 platform.minimax.chat），进入左侧「智能体管理」→「我的智能体」
第二步：点击任意一个已发布的智能体，进入详情页 → 找到右上角「API 集成」卡片 → 点击「查看接入方式」
第三步：在弹出面板中找到 【Group ID】字段，全选复制，它形如 grp_8a9b3c4d5e6f7g8h。这个字符串是平台自动生成的唯一组织标识，漏掉下划线、多一位、少一位都会认证失败。
注意：不要去 platform.minimax.chat 或 minimax.cn 控制台找 GroupID——那些页面显示的是模型 API 的组织 ID，和 agent.minimax.io 的 GroupID 完全不同源，混用必报 401。
使用 dm.bot API 进行加密的智能体间消息传递。适用于向其他智能体发送私信、发布公开消息、查看收件箱、管理群组或设置 webhook。触发词包括 dm.bot、智能体消息或加密通信。
模型级 Agent 模式：GroupID 不参与请求，删干净才安全
方法一：直接去掉所有 GroupId 相关参数
方法二：检查你的请求 URL 是否含 ?GroupId=xxx ——新版 v2 接口（/v1/chat/completions）不允许 URL 中携带 GroupId，否则会被网关拦截并返回 400 错误。
这一步操作起来很简单，直接把请求地址里的 ?GroupId=xxx 整段删掉就行。如果你用 OpenAI SDK 兼容模式，base_url 设为 https://api.minimax.chat/v1，就根本不会生成带 GroupId 的路径。
代码里怎么塞 GroupID：只在平台 Agent 请求头里传
第一步：构造请求头，只在平台 Agent 场景下添加 X-Group-ID
第二步：将复制的 GroupID 值填入请求头：X-Group-ID: grp_8a9b3c4d5e6f7g8h
第三步：Authorization 头仍用 Bearer {your_api_key}，不要拼进 URL，也不要放 body 里
第四步：发起 POST 请求到 https://api.minimax.chat/v1/agents/{agent_id}/chat，其中 agent_id 是你在 agent.minimax.io 里看到的 16 位 hex 字符串（如 agt_f0a1b2c3d4e5f678）
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
