先验证请求是否触达MiniMax网关层，通过curl直连并检查响应头WWW-Authenticate字段；再严格校验Authorization头格式；接着确认API Key与域名物理配对；然后排查模型权限是否开通；最后根据code字段精准定位错误类型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认请求是否触达MiniMax网关层
先验证请求有没有真正发到MiniMax服务端，而不是卡在本地或中间代理。用curl直连是最可靠的第一步。
执行命令：curl -v -X POST "https://api.minimax.chat/v1/text/chatcompletions" -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"abab6.5-chat","messages":[{"role":"user","content":"test"}]}'
重点看响应头中是否有WWW-Authenticate: Bearer realm="minimax"——有，说明已通过网关鉴权模块；没有，说明请求压根没进网关，问题出在DNS、本地hosts、代理设置或base_url拼写错误上。
检查Authorization头格式是否被严格校验
MiniMax服务端对Authorization字段执行正则硬匹配，只接受形如Bearer sk-xxxxxxxx的原始字符串。
必须确保Bearer后紧跟一个英文半角空格，再接完整密钥；不能是"Bearer" + api_key（缺空格）、"Basic " + base64编码（错类型）、或把密钥直接塞进body里。
【密钥复制时极易混入前后换行符或全角空格】建议粘贴到VS Code中开启“显示不可见字符”再提取。
核对API Key与域名是否物理配对
国内版密钥（来自minimaxi.com）只能用于https://api.minimaxi.com/v1；国际版密钥（来自minimax.chat）只能用于https://api.minimax.chat/v1。二者物理隔离，混用必报401。
登录控制台→「API密钥管理」→点开对应密钥→查看“来源域名”，再比对你代码里写的base_url，一字不差才算匹配。
若用LangChain或Clawdbot封装，必须显式传入base_url参数，不能依赖默认值。
排查模型权限是否实际开通
403 Forbidden不是密钥问题，是权限没开。即使密钥正确、URL无误，也会被网关拦截。
开源 B2B AISDR 模板，7 层上下文系统配 10 阶段销售流程，4 层防遗忘记忆，13 个自动化定时任务，WhatsApp IP 隔离...
第一步：登录platform.minimaxi.com →「API密钥管理」→找到密钥 → 点击「作用域」
第二步：确认勾选了目标模型的invoke权限项——abab6.5-chat和MiniMax-M3是两个独立权限项，勾了一个不代表另一个自动开通。
第三步：检查请求体中model字段值是否与控制台里已授权的模型名称完全一致，包括大小写、连字符、版本号（例如abab6.5s ≠ Abab6.5s）。
识别内部code字段的真实含义
HTTP状态码只是门禁，code才是房间号。同一个400下，code=2013和code=2001修复路径完全不同。
方法一：code=2013 → 立刻检查messages里每个元素的role字段——M3严格只接受"user"、"assistant"、"system"三种小写字符串。【developer、bot、AI等自定义role会直接触发2013】
方法二：code=2001 → 检查JSON结构：model字段必须存在且为非空字符串；messages必须是非空数组；每个message必须含role和content；content不能是null或空字符串。
方法三：code=4000 → 说明URL路径无效。核对是否漏掉/text/层级（正确是v1/text/chat，错写成v1/chat）；末尾是否多加斜杠（v1/text/chat/会失败）；是否用了已被废弃的旧路径。
应对429限流的即时操作
收到429别急着重试，先看响应头：X-RateLimit-Remaining为0且X-RateLimit-Reset早于当前时间，说明配额已彻底耗尽，此时重试毫无意义。
免费用户默认RPM=5，实测连续发6个请求就会触发——【不要用for循环暴力测试】
立即生效的降频动作：在每次请求前插入random.uniform(0.1, 0.5)秒随机延迟；读取Retry-After头并sleep对应秒数；把大请求按段落切分为多个小请求分别发送。
