必须正确设置纯数字格式的group id环境变量,否则旧版minimax接口将返回401错误;group id需从platform.minimax.chat账户中心→组织管理中获取,linux/macos通过shell配置文件设置,windows可通过图形界面或powershell设置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在本地开发环境中正确设置 MiniMax Agent 所需的 GroupID,否则调用旧版接口时会返回 401 错误而非明确的参数缺失提示。
确认 GroupID 获取路径
登录 platform.minimax.chat → 左侧菜单进入「账户中心」→「组织管理」→ 找到「Group ID」字段(一串纯数字,非字符串格式)→ 复制保存。注意:该 ID 在控制台中不叫 Account ID,也不叫 Organization ID,仅显示为 Group ID。
【Group ID 是旧版接口必需参数,且必须为纯数字,填错或填成字符串会导致 401 认证失败】
Linux/macOS 环境变量配置
打开终端,执行以下命令写入 shell 配置文件:
若使用 zsh(macOS 默认):echo 'export MINIMAX_GROUP_ID=你的GroupID数字' >> ~/.zshrc && source ~/.zshrc
若使用 bash:echo 'export MINIMAX_GROUP_ID=你的GroupID数字' >> ~/.bashrc && source ~/.bashrc
这一步操作起来很简单,直接把上面那行命令里的“你的GroupID数字”替换成你复制的实际数字即可。
Windows 环境变量配置
方法一:图形界面设置
右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→ 在「系统变量」区域点击「新建」→ 变量名填 MINIMAX_GROUP_ID → 变量值填你复制的纯数字 Group ID → 点击确定。
MiniMax 语音合成技能 - 支持同步/异步文本转语音(T2S)、音色克隆(Voice Clone)、音色设计(Voice Design)、音色查询与删除。使用模型 speech-2.8-hd,输出 mp3/wav/pcm 音频文件至本地。
方法二:PowerShell 一次性设置(仅当前会话有效)
$env:MINIMAX_GROUP_ID="123456789"(把 123456789 换成你的真实 Group ID)
注意:PowerShell 方式设置的变量不会持久化,关闭窗口即失效,仅适合临时调试。
验证环境变量是否生效
第一步:打开新终端(Windows 请重新启动 PowerShell 或 CMD,macOS/Linux 请新开一个 Terminal)
第二步:执行命令检查变量值
Linux/macOS:echo $MINIMAX_GROUP_ID
Windows(CMD):echo %MINIMAX_GROUP_ID%
Windows(PowerShell):$env:MINIMAX_GROUP_ID
第三步:确认输出为你复制的纯数字 Group ID,且无空格、引号、字母或其他符号。










