必须正确传入Group ID才能成功调用MiniMax Agent API，否则即使API Key正确也会返回401错误；需登录https://platform.minimax.io，进入「组织管理」页面复制完整的grp_开头32位Group ID，并使用专用接口https://api.minimax.chat/v1/text/chatcompletion，请求体中必须含agent_id字段，且Group ID不参与Header或参数传递。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在代码中成功调用MiniMax智能体（Agent）API，必须正确获取并传入Group ID，否则即使API Key正确也会返回401错误，且该错误极易被误判为密钥失效。
登录控制台并定位Group ID入口
打开浏览器，访问官方最新入口 https://platform.minimax.io（注意不是minimaxi.com或minimax.chat等历史旧域名），使用已实名认证的邮箱或手机号登录。
登录后，点击右上角头像 → 选择「账户中心」→ 左侧菜单栏切换至「组织管理」。
在「组织管理」页面中，找到明确标注为【Group ID】的字段，它是一串以grp_开头、长度约32位的字符串（如grp_8a9b3c4d5e6f7g8h9i0j1k2l3m4n5o6p），【务必全选复制，不可遗漏下划线或任意字符】。
确认当前调用的是Agent专用接口路径
MiniMax Agent调用不走通用chatcompletion接口，必须使用专有路径：https://api.minimax.chat/v1/text/chatcompletion。
该接口要求请求体JSON中必须包含agent_id字段，同时Header中需携带Bearer认证——但group_id不在此处传，它仅用于旧版v1接口的query参数，Agent调用时无需拼接。
注意：若你误用了/v1/text/chatcompletion_v2路径，即使Group ID和API Key都正确，也会因接口不支持Agent能力而直接返回404。
在Python中安全配置并发起Agent调用
方法一：环境变量方式（推荐）
在系统环境或shell中设置：
export MINIMAX_API_KEY="key_xxx"
export MINIMAX_GROUP_ID="grp_xxx"
然后在Python脚本中读取：
import os
API_KEY = os.environ["MINIMAX_API_KEY"]
GROUP_ID = os.environ["MINIMAX_GROUP_ID"]
方法二：代码内硬编码（仅限本地测试）
直接赋值，但必须确保文件不提交至Git或公开仓库：
API_KEY = "key_XXXXXXXXXXXXXXXXXXXXXXXX"
GROUP_ID = "grp_XXXXXXXXXXXXXXXXXXXXXXXX"
构造请求时，【Agent调用不需要把GROUP_ID塞进headers或params】，只需保证API_KEY正确即可；真正需要传的是agent_id，它来自你在Agent模块创建并发布的实例ID。
验证调用是否成功
第一步：用Postman或curl发送最简请求
POST https://api.minimax.chat/v1/text/chatcompletion
Headers：
Authorization: Bearer your_api_key_here
Content-Type: application/json
Body（JSON）：
{
"agent_id": "agt_xxx",
"messages": [
{"role": "user", "content": "你好"}
]
}
第二步：检查响应状态码是否为200
第三步：解析返回JSON，定位choices[0].message.content字段，确认内容非空且语义合理。
如果返回401，请立即核对API Key是否复制完整、是否过期、是否属于同一项目；如果返回404，说明agent_id填写错误或未发布成功。
