必须同时提供有效的 Group ID 和 API Key 并按接口版本匹配传参方式：v1 接口需将 group_id 作为 query 参数拼入 URL，v2 接口虽可省略但跨组织场景仍需显式传入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 MiniMax 平台调用 Agent 接口并确保请求被正确鉴权和路由到所属组织，必须同时提供有效的 Group ID 和 API Key，并按接口版本严格匹配传参方式——旧版 v1 接口要求 group_id 作为 query 参数拼入 URL，缺一不可；新版 v2 接口虽可省略 group_id，但若项目归属多组织或存在跨 group 调用场景，仍需显式传入，否则可能命中错误的配额池或权限策略。
获取 Group ID 和 API Key
登录 MiniMax 官方开发者控制台（当前有效入口为 https://api.minimax.chat/console），使用已实名认证的账号进入「API 密钥管理」页面。
点击【创建新密钥】，填写应用名称（如“客服机器人”），选择对应项目后确认生成。
密钥生成后，页面立即显示 【api_key（sk-开头）】 和 【group_id（grp_开头，16位十六进制字符串）】 ——这两项仅在此刻完整可见，关闭页面即不可再查，务必全选复制并保存至安全位置。
区分接口版本决定传参方式
新版 v2 接口路径为 /v1/text/chatcompletion_v2，认证仅需 Header 中携带 Authorization: Bearer {api_key}，group_id 通常不强制传入。
旧版 v1 接口路径为 /v1/text/chatcompletion，必须将 group_id 作为 query 参数拼在 URL 后面，例如：https://api.minimax.chat/v1/text/chatcompletion?group_id=grp_abc123；若遗漏，服务端返回 401 错误而非明确提示参数缺失，极易误判为密钥失效。
注意：Agent 类接口（如调用已发布的智能体）默认走 v1 路径，除非文档明确标注支持 v2，否则一律按旧版规则处理。
安全注入凭证到运行环境
方法一：使用 .env 文件（推荐）
在项目根目录新建 .env 文件，写入两行：
MINIMAX_GROUP_ID=grp_abc123
MINIMAX_API_KEY=sk-xyz789
Python 中加载：from dotenv import load_dotenv; load_dotenv()。
方法二：直接设置系统环境变量
Linux/macOS 终端执行：export MINIMAX_GROUP_ID="grp_abc123" && export MINIMAX_API_KEY="sk-xyz789"；Windows PowerShell 执行：$env:MINIMAX_GROUP_ID="grp_abc123"; $env:MINIMAX_API_KEY="sk-xyz789"。
方法三：代码中声明（仅限调试，禁止提交至 Git）
直接赋值：GROUP_ID = "grp_abc123"、API_KEY = "sk-xyz789"；这一步操作起来很简单，但上线前必须删掉，否则密钥会随代码泄露。
构造含 Agent ID 的请求（以旧版 v1 为例）
第一步：确认 Agent 已发布，在 Agent 详情页复制 【Agent ID（agt_开头）】 和测试 Token（或复用项目级 API Key）。
第二步：组装请求 URL：https://api.minimax.chat/v1/text/chatcompletion?group_id=grp_abc123。
第三步：设置 Headers：{"Authorization": "Bearer sk-xyz789", "Content-Type": "application/json"}。
第四步：构造 Body JSON，确保包含 "agent_id": "agt_def456" 和 "messages": [{"role": "user", "content": "你好"}]；缺少 agent_id 字段会导致 404，不是 401。
