跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

Minimax API 报错 401 Unauthorized 排除步骤

401错误表明身份验证失败,需依次检查:一、API Key是否正确配置;二、Authorization请求头是否完整传递;三、Key是否具备对应接口权限;四、环境变量中是否存在隐式截断;五、若启用签名认证,需验证时间同步与签名时效性。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜如果您在调用 Minimax API 时收到 401 Unauthorized 错误,说明请求未通过身份验证,服务器拒绝处理该请求。以下是排除此问题的具体步骤:

一、检查 API Key 是否正确配置

Minimax API 要求在请求头中携带有效的 Authorization 字段,其值为 Bearer 后接正确的 API Key。若 Key 缺失、拼写错误或被意外截断,将直接触发 401 响应。

1、登录 Minimax 官方控制台,进入「API 密钥管理」页面。

2、确认当前使用的 API Key 处于「启用」状态,且未过期。

3、复制完整 Key 值(注意:Key 通常以sk-开头,共 64 位字符,不含空格或换行)。

4、检查代码中 Authorization 头的构造方式,确保格式为Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。

二、验证请求头中 Authorization 字段是否完整传递

部分 HTTP 客户端或代理可能过滤、覆盖或未正确设置 Authorization 请求头,导致服务端无法读取凭证。

1、使用 curl 命令手动测试,绕过应用层封装:curl -X POST "https://api.

minimax.chat/v1/chat/completions" \-H "Authorization: Bearer sk-..." \-H "Content-Type: application/json" \-d '{"model": "abab6.5-chat", "messages": [{"role": "user", "content": "hello"}]}'2、在代码中打印实际发出的请求头(非预设变量),确认 Authorization 字段存在且值非空。

3、检查是否误将 Key 放入 body 或 query 参数中——Minimax 仅接受其位于Authorization 请求头中。

三、确认所用 API Key 具备对应接口调用权限

Minimax 控制台支持按 Key 粒度分配权限范围,若 Key 仅授权访问 v1/llm/chat 接口,则调用 v1/chat/completions 将返回 401。

1、在控制台中定位该 API Key 的「权限策略」设置项。

MiniMax Hub MiniMax推出的画布式AI创意生成工具,支持AI视频、图像、音频、文案等多模态生成和工作流搭建下载2、核对已勾选的服务路径是否包含当前请求的完整 endpoint,例如/v1/chat/completions或/v1/llm/chat。

3、若使用的是子账号生成的 Key,需由主账号确认该子账号已被授予对应 API 服务的调用权限。

四、排查环境变量或配置文件中的隐式截断

某些开发环境(如 VS Code 终端、Docker env 文件、.env 加载器)会对末尾空格、不可见 Unicode 字符或换行符敏感,导致 Key 实际传入时被截短或污染。

1、在代码中打印 API Key 长度:len(os.getenv("MINIMAX_API_KEY")),确认是否为 64。

2、将 Key 值粘贴至十六进制编辑器(如 onlinehexeditor.com),检查是否存在U+200B(零宽空格)

或U+000A(换行)

等隐藏字符。

3、改用硬编码临时测试(仅限本地调试),排除配置加载逻辑干扰。

五、验证时间同步与签名时效性(如启用 Signature 认证)

当 Minimax API 启用可选的签名认证模式(非默认 Bearer 模式)时,请求头需包含 X-MiniMax-Timestamp 和 X-MiniMax-Signature,且时间戳偏差超过 300 秒即视为非法。

1、在发起请求前,获取当前 Unix 时间戳(秒级),并确保其与 NTP 标准时间偏差小于300 秒。

2、检查 X-MiniMax-Timestamp 头是否为纯数字字符串,无小数点或单位后缀。

3、重新生成签名时,确认所用 secret_key 与控制台中显示的Secret Key(非 API Key)

完全一致,且未混淆二者。

相关文章