调 DeepSeek API 遇到报错，先看错误码数字——每个码对应明确的官方解释与下一步动作。以下逐条对照来自 DeepSeek 官方错误码文档（api-docs.deepseek.com，核对时间 2026 年 11 月 2 日），按出现频率与处理路径整理。
七种错误码逐条对照
| 错误码 | 官方原因 | 下一步动作 |
|---|---|---|
| 400 | 请求体格式错误 | 按报错信息逐字段检查 JSON：引号、逗号、字段名拼写 |
| 401 | 认证失败 | 检查 API key 是否正确、是否带错前缀；没有 key 先在平台创建 |
| 402 | 账号余额不足 | 确认余额，前往充值页充值；账单对不上先查多算的四笔 |
| 422 | 请求体参数错误 | 与 400 的区别：格式对但参数不合法（如超限值），对照官方参数表改 |
| 429 | 请求速率或并发达到上限 | 降低发送频率或并发数；限速规则见接口调用与限流一篇 |
| 500 | 服务器内部故障 | 等待后重试；持续出现再反馈官方 |
| 503 | 服务器负载过高 | 稍后重试；多为高峰容量问题，错峰与应急见服务器繁忙怎么办 |
处理顺序固定三步：先认码（错误信息开头的三位数字）——再对照（上表找对应行）——后动作（按「下一步动作」列执行）。多数卡壳发生在跳步：不认码就重启程序，白折腾。
几组容易混的对照
400 与 422：都是你的请求有问题，区别在 400 是格式层面（JSON 写坏了），422 是参数层面（格式对但值不合法）。遇到 422 优先怀疑三处：参数名拼错、取值超范围、模型名不存在的变体。
429 与 503：都是「被拒」，但 429 是你的速率或并发超限（改自己的调用节奏就能解），503 是服务端负载高（只能等或错峰）。看到 429 别加钱，看到 503 别改代码——方向反了白忙。
401 与 402：401 是「你是谁没证明」（key 问题），402 是「你是谁已证明但没钱了」（余额问题）。脚本里这两种最常见于换环境后：key 环境变量没带上是 401，团队共用账户额度耗光是 402。
峰谷定价生效后，503 的出现时段与高峰高度相关（北京 09:00-12:00、14:00-18:00 为高峰），批量任务挪到谷时既便宜又少撞限，账单算法见峰谷与选档。
用 AI 帮你读报错
报错信息可以整个贴给 AI 帮你定位，注意脱敏：去掉 API key 与业务数据。
提示词起手式（报错分析）：「我在调用 DeepSeek API 时遇到如下报错：[贴报错原文，去掉 key 与敏感数据]。我的请求要点：模型名 [xxx]、是否有流式、大约每分钟几次。请按可能性排序给出三个排查动作，每个动作给出具体改法；不确定的地方标注『需要我补充信息』。」
常见问题
- 网页版聊天提示「服务器繁忙」，是哪个码？网页端不展示数字码，对应的就是 503 一类的高峰容量问题，排查路径不同（关深度思考、错峰、看状态页），见专文。
- 重试有讲究吗？429 与 503 类重试要加间隔（几秒起步逐次拉长），立刻猛重试只会让限流更久；400/401/402/422 类重试无意义，先改请求。
- 哪里看官方原始口径？DeepSeek API 文档的错误码页，本文对照以它为准，若官方有更新以官方为准。
信息来源
- DeepSeek 官方错误码文档（api-docs.deepseek.com/zh-cn/quick_start/error_codes，核对时间 2026-11-02）：七种错误码的原因与解决方法；
- 站内条目：DeepSeek接口（工具页）、接口调用与限流、服务器繁忙、账单四笔。
