接入大模型 API 时，九成以上的问题都落在下面六类报错里。这篇按"报错 → 原因 → 解法"的格式整理，建议收藏，出问题时对号入座，基本都能 30 秒自救。
401 Unauthorized —— 鉴权失败
含义：服务器认识你，但你出示的"房卡"不对。
- Key 复制不完整或前后带了空格（最常见，没有之一）
- Key 已被删除或重置——去控制台「令牌」页确认状态是启用
- 客户端里把 Key 填到了错误的格子（比如填进了"模型名"）
解法：回控制台重新复制完整 Key，重新粘贴保存。如果反复失败，直接新建一个令牌替换。
404 / model not found —— 模型不存在
含义：Key 是对的，但你要的"菜"不在菜单上。
- 模型 ID 拼写错误：必须原样填写，deepseek-v4-flash-0731 不能写成 deepseek 或 v4-flash
- 大小写敏感：MiniMax-M3 和 minimax-m3 是两个不同的 ID
- 该模型已下线或暂时不可用
解法：打开模型列表页，复制粘贴模型 ID，不要手打。
429 Too Many Requests —— 触发限流
含义：请求太频繁，被"限速"了。这不是故障，是保护机制。
- 脚本并发太高、循环调用之间没有间隔
- 多个人共用同一个 Key 同时高频使用
解法：脚本里给请求之间加 1~2 秒间隔；批量任务改成分批跑。持续触发限流可联系我们调整额度。
402 / 余额不足
含义：账户余额用完了。控制台「明细」页能看到每一笔消耗，先确认消耗速度是否符合预期——如果余额掉得异常快，检查是不是有长文本在反复调用，或者 Key 泄露被别人用了（改密码 + 重置令牌）。
超时 / 无响应
含义：请求发出去了，但一直没等到结果。分两种情况：
- 旗舰模型生成慢——复杂问题的深度推理本来就需要更久，属正常现象，换 flash 后缀的轻量模型对比即可判断
- 本地网络问题——换一个网络环境（比如切手机热点）重试，能通就是原网络的问题
内容为空 / 回复截断
含义：有响应但不完整。
- max_tokens 参数设小了，调大即可
- 个别客户端默认上下文长度受限，在设置里调大"最大回复长度"
30 秒自救清单
- Key 重新完整复制一遍 → 解决 401
- 模型 ID 从模型列表页复制 → 解决 404
- 请求间隔加 2 秒 → 解决 429
- 换轻量模型对比 → 判断是否真的"慢"
- 控制台查明细 → 判断余额与异常消耗
以上都试过还不行？公众号 AIGC_breeze 或邮件 707281081@qq.com 找我们，把报错截图发来，比你自己折腾快。