401错误源于身份验证失败，主因是端点与api密钥不匹配、authorization头格式错误、agent权限未开通或环境变量截断。需严格核对域名（minimaxi.com/国内版 vs minimax.chat/国际版）、bearer后单空格+64位密钥、作用域含agents:invoke，并验证环境变量无隐式截断。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用MiniMax Agent API时收到401错误，说明请求未通过身份验证，服务器拒绝处理该请求——这通常不是密钥本身失效，而是端点错配、Authorization头格式不合规、代理干扰或权限未开通导致。
确认API密钥与端点严格匹配
国内版（minimaxi.com）与国际版（minimax.chat）使用物理隔离的鉴权系统，密钥和域名必须一一对应。混用会直接触发token is unusable (1004)，且错误提示不说明原因。
第一步：打开Minimax控制台，进入「API密钥管理」，查看密钥来源域名——若页面地址是https://platform.minimaxi.com，则密钥属于国内版；若为https://console.minimax.chat，则属国际版。
第二步：检查代码或配置中base_url是否与密钥来源一致。国内版必须用https://api.minimaxi.com/v1，国际版必须用https://api.minimax.chat/v1。二者不可互换，【哪怕只差一个字符，比如minimaxi.com写成minimaxi.cn，也会返回401】。
第三步：若使用OneAPI等网关层，需确认其内部转发时未篡改Host头或重写URL路径——有些网关会把api.minimaxi.com自动转为minimaxi.com，导致鉴权模块收不到原始域名。
校验Authorization请求头格式
MiniMax服务端对Authorization字段执行正则硬匹配，仅接受形如Bearer sk-xxxxxxxx的原始字符串，任何偏差都会立即拒绝。
方法一：在代码中打印完整headers字典，确认Authorization字段值为单行纯字符串，无换行、无前后空格、无引号包裹。
方法二：用curl直连验证，绕过所有封装逻辑：
curl -v -X POST "https://api.minimax.chat/v1/text/chat" -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"abab6.5-chat","messages":[{"role":"user","content":"test"}]}'
注意：Bearer后必须是一个英文半角空格，再接密钥——中文空格、全角空格、零宽字符、冒号、等号都会失败。
检查Agent专属权限是否开通
Agent类接口（如/v1/agents/run、/v1/agents/{agent_id}/invoke）需要单独授权，普通LLM密钥默认不包含此项权限。
登录Minimax控制台 → 「API密钥管理」→ 找到目标密钥 → 点击「作用域」→ 滚动查找是否有Agent Execution或agents:invoke选项并已勾选。没有就手动开启。
如果使用子账号创建的密钥，主账号需进入「组织管理 → 成员权限」，确认该子账号已被授予Agent服务调用权限。
这一步容易被忽略：即使密钥能成功调用/v1/text/chat，也不代表它能调用Agent接口。
排查环境变量隐式截断
密钥在加载过程中可能被截断或污染，尤其在Docker或CI/CD环境中。
执行echo $MINIMAX_API_KEY | wc -c，检查输出是否为65（含末尾换行符）或64（纯密钥长度）。若少于64，说明变量被截断。
在VS Code中打开密钥字符串，开启「显示不可见字符」，确认无\r、\n、全角空格或零宽字符。复制密钥时务必从控制台「复制」按钮点击获取，不要手动拖选。
若使用.env文件，确保文件编码为UTF-8无BOM，且每行末尾无多余空格。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
