minimax agent 调用失败主因是 groupid 配置错误：v2 接口无需传 groupid，v1 接口必须显式拼接；需确保 api key 与 groupid 同属一个组织层级，且 groupid 为 32 位小写 hex 格式 gr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent 调用时因 GroupID 配置错误导致请求失败，常见于旧版接口混用新版鉴权机制、跨子账户密钥错配或 URL 拼接污染，直接触发 401/1004 或 429/1008 等非预期状态码。
确认当前接口版本与 GroupID 是否需要传参
第一步：打开 MiniMax 控制台 →「模型服务」→「API 文档」，查看你正在调用的 endpoint 路径。若路径以 /v1/chat/completions 或 /v1/text/chatcompletion_v2 结尾，则属于 v2 兼容接口，【GroupID 不再需要传参】，Bearer Token 已绑定组织上下文；若路径含 ?GroupId=xxx 或为 /v1/text/chatcompletion，则属 v1 旧版接口，必须显式拼接 GroupId。
第二步：检查代码中是否同时做了两件事——既在 URL 里拼了 GroupId，又在 Authorization 头里用了 v2 绑定的 Key。这会导致服务端解析冲突，直接返回 401（code=1004）。
排查 GroupID 与 API Key 归属是否一致
方法一：登录 platform.minimaxi.com →「项目管理」→「成员管理」，确认当前 API Key 所属子账户与你要调用的 GroupID 是否在同一组织层级下。若 Key 来自主账户，而 GroupID 属于子账户 A，则平台会将请求视为“未认证用户”，触发 【429 + status_code=1008】，此时控制台余额充足也无效。
MasterCard Agent Pay兼容卡片、钱包及支付，为代理商与OpenClaw机器人提供财务管理。
方法二：在控制台「API 密钥管理」页面，点击该 Key 右侧「详情」，查看「所属项目」和「作用域」中列出的 Group 列表。若目标 GroupID 不在其中，说明该 Key 根本无权访问该 Group，必须换 Key 或请主账户授权。
验证 GroupID 字符串本身是否合法
① 登录 platform.minimaxi.com →「团队设置」→「组织信息」，复制顶部显示的 Group ID（注意不是 Project ID），它应为 32 位小写字母+数字组合，形如 gr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。
② 检查代码中是否误用了 Project ID（以 pr- 开头）、User ID（以 us- 开头）或旧版 GroupId（含大写字母或下划线）。MiniMax 服务端对 GroupId 执行严格格式校验，任何偏差都会返回 400 或 404。
③ 若通过环境变量注入 GroupId，执行 echo $MINIMAX_GROUP_ID 并比对控制台原始值。常见错误是复制时多选了一个不可见换行符，或粘贴进 YAML 配置时被自动缩进截断。
