必须准确配置GroupID：v2接口无需传GroupID，仅需Bearer Token；v1接口必须将GroupID作为query参数拼入URL，遗漏或错误均导致401错误，且需通过控制台或endpoint路径确认接口版本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 MiniMax Agent API 中正确发起请求并避免 401 或 1004 错误，必须准确配置 GroupID——它不是可选字段，而是与 API Key 绑定组织权限的核心标识，传错位置或遗漏将直接导致鉴权失败，且错误码不提示真实原因。
确认当前使用的接口版本
新版 Agent API（v2 兼容路径）与旧版（v1）对 GroupID 的处理逻辑完全不同，混用必报错。先打开 MiniMax 控制台 → 进入「模型服务」→ 查看目标 Agent 模型右侧标注的「接口版本」，或在模型详情页 URL 中识别 /v1/chat/completions（v2）或 /v1/text/chatcompletion（v1）。
若控制台未明确标注，请以你调用的 endpoint 路径为准：路径含 chat/completions 即为 v2；含 text/chatcompletion 即为 v1。
v2 接口：GroupID 不参与请求构造
新版 v2 接口已将 GroupID 与 API Key 在服务端完成绑定，无需在请求中显式传递。
第一步：设置 Authorization 头为 Bearer {your_api_key}，确保该 key 是在对应 Group 下创建的。
第二步：发送 POST 请求至 https://api.minimax.chat/v1/chat/completions，URL 中不得拼接任何 GroupId 参数，query string 留空。
第三步：在请求体 JSON 的 messages 数组前，添加 system 角色消息说明 Agent 行为约束，例如：{"role": "system", "content": "你是一个执行任务的智能体，只输出 JSON 格式动作指令，不解释、不寒暄"}。这一步影响 Agent 解析逻辑，不加可能导致响应格式异常。
v1 接口：GroupID 必须作为 query 参数拼入 URL
旧版接口不校验 Bearer Token 所属 Group，仅靠 URL 中的 GroupId 做权限路由，漏传或传错值会返回 401，而非更明确的 400 缺参错误。
方法一：手动拼接 URL
取完整 endpoint：https://api.minimax.chat/v1/text/chatcompletion?GroupId=123456789，其中 123456789 替换为你在控制台复制的真实 Group ID，注意是数字字符串，不是应用名或别名。
AI编程系统协调器。触发词：开发、实现、创建、添加、修复、报错、重构、优化、review、评审、继续、为什么、记住、保存经验、复盘、分析、学习、参考、模仿、/evolve
方法二：用 SDK 自动注入（以 Python minimax-api 为例）
初始化 Client 时必须显式传入 group_id：client = Client(api_key="xxx", group_id="123456789")；否则 SDK 默认不带 GroupId，请求发出去就是 401。
注意：SDK 初始化时若 group_id 值为空字符串、None 或纯空格，不会报错但会导致请求 URL 缺失 GroupId，最终仍 401。
安全加载 GroupID 的实操方式
第一步：在项目根目录创建 .env 文件，写入：
MINIMAX_GROUP_ID=123456789
MINIMAX_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
第二步：Python 脚本开头加载环境变量：from dotenv import load_dotenv; load_dotenv()。
第三步：读取并校验非空：group_id = os.getenv("MINIMAX_GROUP_ID") → 必须检查 group_id.strip() != ""，因为 .env 文件末尾换行或空格会导致值为 "\n"，看似有值实则无效。
第四步：构造请求时，若走 v1 接口，用 f"https://api.minimax.chat/v1/text/chatcompletion?GroupId={group_id}" 拼接；若走 v2 接口，直接忽略该变量，仅用于本地调试日志输出。
