MiniMax Agent 的 Group ID 不仅是身份标识，更决定权限层级、资源配额归属和跨服务调用能力；填错或混用会导致 Agent 加载失败、工具调用被拒，甚至触发 401 或 1039 报错，因其严格绑定 Agent 所属 Group 与调用凭证的归属一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent 的 Group ID 不是单纯的身份标识，它直接绑定账号权限层级、资源配额归属和跨服务调用能力，填错或混用会导致 Agent 无法加载、工具调用被拒、甚至触发 401 或 1039 报错。
Group ID 决定 Agent 能否被正确加载
Agent 在 MiniMax 控制台创建时，会默认绑定到当前登录账号所属的 Group。调用该 Agent 时，请求中必须携带与之匹配的 Group ID（旧版接口）或确保 API Key 所属 Group 与 Agent 注册 Group 一致（新版 v2 接口虽不显式传 Group ID，但鉴权时仍校验归属关系）。
如果用测试账号的 API Key 去调生产环境创建的 Agent，即使 model_id 和 endpoint 都对，也会返回 【1039 model_not_found】——系统根本找不到这个 Agent，因为它不在当前 Group 的作用域内。
这一步不能跳过：登录 platform.minimaxi.com → 进「Agent 管理」→ 点开目标 Agent → 查看右上角显示的「所属 Group」，必须和你调用时使用的凭证完全一致。
使用APIDot进行MiniMax Music 2.6 API工作流程，包括AI音乐生成、歌词创作、器乐制作、音频导出规划、异步任务提交、任务ID...
Group ID 控制 Agent 可访问的工具和服务范围
MiniMax 的 Agent 权限模型是 Group 粒度的。你在控制台为某个 Group 开通了「数据库查询插件」或「企业微信 Webhook 工具」，那么只有该 Group 下创建或授权的 Agent 才能调用这些能力。
方法一：在控制台「工具管理」页为指定 Group 批量授权工具
方法二：在 Agent 编辑页点击「权限配置」→ 选择「仅限本 Group」或「跨 Group 共享」（后者需对方 Group 主管理员手动接受邀请）
【跨 Group 共享必须双方 Group 主管理员完成双向确认，单方面开启无效】
Group ID 影响 Agent 的配额计算与限流行为
Agent 的 TPM/RPM 配额不是按账号算，而是按 Group 统计。同一个账号下多个 Group，每个 Group 的额度独立计算。
第一步：确认你的 Agent 请求实际走的是哪个 Group 的额度
第二步：检查 platform.minimaxi.com → 「配额中心」→ 切换到对应 Group → 查看「Agent 调用」分类下的实时消耗
第三步：若看到 429 错误且 status_code 是 1008，优先排查是否 Group ID 与 API Key 不匹配导致系统误判为“未认证用户”，从而套用最低档限流策略
这一步容易被忽略：免费层 Group 的 RPM 上限可能低至 3 次/分钟，哪怕 Agent 本身没调用任何工具，光是初始化 session 就可能占掉一次配额。
