minimax agent接口401错误主因是group id未正确配置：必须为18–22位纯数字，仅通过url query参数（如?groupid=xxx）传递，且需绑定coding plan套餐；api key和account id不可替代。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在调用 MiniMax Agent 接口时遇到 401 错误，或发现请求被拦截却查不到扣费记录，大概率是 Group ID 没配对、没传对，或额度归属路径错位。MiniMax 的 Agent 调用强制绑定 Group ID，且该 ID 直接决定费用从哪个账户/套餐里扣除，不是可选字段。
确认 Group ID 的真实来源
Group ID 不是 API Key，也不是 Account ID，它是一串纯数字，长度为 18～22 位，形如 【123456789012345678】，只在两个地方能准确拿到：
第一步：登录 platform.minimaxi.com → 点击右上角头像 →「账户中心」→「组织管理」→ 找到当前活跃组织右侧的「Group ID」，点击复制。
第二步：若你使用 Coding Plan 套餐（Starter/Plus/Max），需额外确认该套餐是否已绑定到此 Group ID。进入「Coding Plan」页面，查看套餐状态栏下方是否显示「已绑定至 Group ID: 123456789012345678」。未绑定则额度不生效，Agent 请求会直接返回 401。
注意：控制台首页展示的「Account ID」是全局账号标识，不能代替 Group ID；API 密钥创建页也不会显示 Group ID。
Agent 接口必须传 Group ID 的两种方式
MiniMax Agent 接口（如 /v1/agent/completions）属于旧版鉴权体系，【必须显式传 Group ID，且只能通过 URL query 参数传递】，Header 中仅放 Bearer Key 不够。
方法一：手动拼接 URL（推荐用于调试）
将 Group ID 拼在 endpoint 后面：https://api.minimaxi.com/v1/agent/completions?GroupId=123456789012345678。这一步漏掉或数字少一位，就会触发 401，而不是 400。
方法二：SDK 配置中显式声明（适用于 OpenClaw 或自研封装）
在 OpenClaw 的 openclaw.json 中，不能只填 apiKey 和 groupId，还需指定 baseUrl 为非兼容路径："baseUrl": "https://api.minimaxi.com/v1"，并确保请求逻辑中自动追加 ?GroupId=xxx。若你启用了 OpenAI 兼容模式（base_url 设为 /v1/chat/completions），Agent 接口将不可用——它不走 OpenAI 兼容路径。
额度扣费路径优先级说明
MiniMax Agent 请求的费用扣除严格按以下顺序匹配可用额度：
① 优先消耗当前 Group ID 绑定的 Coding Plan 套餐剩余次数（如 Starter 的 40次/5小时）；
② 套餐用尽后，自动 fallback 到该 Group ID 对应主账户的现金余额；
③ 若主账户余额为 0，且无其他有效套餐，则报 Insufficient Balance 并中断请求。
关键点：Coding Plan 是按 Group ID 绑定的，不是按 API Key 绑定。同一个 API Key 可关联多个 Group ID，但每次请求只归属一个 Group ID 对应的额度池。切换 Group ID 就等于切换扣费账户。
如果你在控制台看到「Coding Plan 已启用」但 Agent 调用仍提示余额不足，说明你用的 Group ID 并未绑定该套餐——去「Coding Plan」页面重新绑定即可。
