DeepSeek API 调用失败,先看返回的错误码再动手:402 是余额不足,充钱才能解决;401 是密钥错了,换对密钥就行;429 是请求太密,降并发、等一等再试。三个码的处理方向完全不同,盲目重试只会浪费时间。
先对上号:官方错误码这样处理
| 错误码 | 意思 | 先做什么 | | 400 | 请求体格式错误 | 按错误提示改请求体 | | 401 | 认证失败,密钥错误 | 核对密钥,没有就先创建 | | 402 | 余额不足 | 确认余额,去充值页充值 | | 408 | 请求超时 | 检查网络后重试 | | 413 | 请求体过大 | 减小上传文件 | | 422 | 参数错误 | 按提示改相关参数 | | 429 | 请求速率或并发到上限 | 合理规划请求速率,降并发 | | 500 | 服务器故障 | 等一等再试 | | 503 | 服务器繁忙 | 稍后重试 | | 504 | 网关超时 | 稍后重试,或减小文件 |
这张表来自 DeepSeek 官方错误码文档,调用失败时先把状态码和错误体一起看,别只看一句报错就下结论。
402 最常见:先查余额,再确认充对了账号
402 的意思是这个密钥背后的账号没钱了,DeepSeek API 是预付费,没有免费额度,不充值就一直失败,重试多少次都没用。先用余额接口查一下:向 api.deepseek.com/user/balance 发请求,is_available 为 false 就是余额不够用。充值去开放平台的充值页,充完一般一分钟内恢复。充了值还是 402,最常见的原因是充错了账号:充值的账号和当前登录的不是同一个,换个登录方式再查充值记录,或者去支付宝、微信的充值订单里看商品条目下对应的是哪个账号。另外注意,有赠送余额时先扣赠送余额,用完或过期后才动充值余额。
429 与 503:能等就等,别硬刷
429 是请求速率或并发到了上限,官方限速按账号计,超了就降并发、拉长间隔,有限重试;如果 429 背后其实是额度耗尽,那就停下来,别硬刷。503、500、504 是服务端的问题,等一等再试,通常几分钟就恢复。还要分清调用方:自己代码调 api.deepseek.com,还是用某个工具、网关里内置的 DeepSeek 模型。后者没钱的可能是对方的账号,所有用户同时报错,你自己充钱也没用,只能等对方处理,或换成自己的密钥和余额。
密钥别贴到公开的地方,也别写进会提交的代码仓库。调通之后顺手给余额设个提醒,把 402 当成停机信号写进代码:遇到 402 直接停下告警,别让程序空转重试。
相关阅读:DeepSeek 免费吗?聊天不花钱,API 按量收费这样算、DeepSeek 总提示服务器繁忙怎么办?先关深度思考再错峰重试