403错误源于GroupID权限未绑定或传参错误：需确认请求GroupID与项目详情页显示的完全一致，确保Agent引擎已在该GroupID下开通并等待同步，且按接口版本要求将GroupID作为query参数传入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent 接口返回 403 错误，且明确与 GroupID 相关时，说明服务已识别你的身份，但拒绝授权访问目标资源——这不是密钥无效，而是权限未绑定到该 GroupID 下的 Agent 能力模块。
确认 GroupID 是否属于当前 Agent 项目
登录 platform.minimax.chat → 进入「项目管理」→ 找到你正在调用的 Agent 项目 → 点击「详情」→ 查看顶部显示的 【Group ID】。这个 ID 必须与你在请求中使用的 GroupID 完全一致，包括数字顺序、位数和是否含前导零。旧版控制台可能显示 Account ID，新版统一为 Group ID，二者不互通。
如果你在代码或配置里填的是另一个项目的 GroupID，哪怕 API Key 正确，也会触发 403 —— 因为 MiniMax 的 Agent 权限是按 GroupID 绑定到具体项目的，不是全局生效。
检查 Agent 模块是否已在该 GroupID 下开通
在同一个项目详情页中，向下滚动至「能力配置」或「服务开通」区域 → 找到「Agent 引擎」或「MiniMax Agent Runtime」开关 → 确认状态为「已启用」。若显示「未开通」或灰显，点击「立即开通」并完成弹窗确认。
AI智能体安全与信任验证。扫描消息、智能体卡及A2A通信中的提示注入、越狱及恶意模式。适用于保护智能体免受攻击、验证外部智能体或扫描不受信任内容。
注意：Agent 不是默认开通的独立服务，它需要单独勾选并计费。即使你已有文本模型调用权限，【Agent Runtime 必须单独开通，且仅对该 GroupID 生效】。开通后需等待 1–2 分钟同步权限，立即重试会仍返回 403。
验证请求中 GroupID 的传参方式是否匹配接口版本
第一步：打开你正在调用的 Agent 接口文档（如 /v1/agent/run 或 /v1/agent/chat），确认其所属版本：
● 若文档路径含 chatcompletion_v2 或明确标注「v2 接口」→ GroupID 不应出现在 URL 或 body 中，仅靠 Bearer Token 绑定；
● 若路径为 /v1/agent/run?GroupId=xxx 或文档示例带 query 参数 → 则必须将 GroupID 作为 URL query 参数传入，且不能放在 header 或 json body 里。
第二步：用 curl 复现请求，严格对照文档格式。例如 v1 接口正确写法：curl -X POST "https://api.minimax.chat/v1/agent/run?GroupId=1234567890" -H "Authorization: Bearer sk-xxx" -d '{"agent_id":"agt_xxx"}'
若把 GroupId 放进 body 或 header，或漏掉问号直接拼路径，都会导致 403。
第三步：检查 SDK 封装逻辑。如果你用的是 LangChain 的 MiniMaxAgent 或 OpenAI 兼容层，某些封装会自动剥离 query 参数。此时必须手动构造 URL，或改用原生 HTTP 请求绕过 SDK 干预。
