DeepSeek API 的报错集中在 7 个 HTTP 错误码上，其中 401 认证失败、402 余额不足、429 速率超限占了大多数。排查思路不复杂：先看返回的状态码，再对照官方错误码表对症处理。本文整理了错误码速查表、通用排查步骤和高频报错场景的解决方法。 DeepSeek API的官方入口与报错查询通道
DeepSeek API 相关的地址有三个，各管一摊：
- 接口基址（https://api.deepseek.com）：写进代码 base_url 的地址。它是接口端点，不是网页，用浏览器直接打开看不到内容页。
另一个容易搞混的入口是 chat.deepseek.com，那是免费的网页对话版，与按量计费的 API 是两套服务。网页版聊得动，不代表 API 余额为正，两边没有关联。
DeepSeek API报错的通用排查步骤
拿到报错先别急着改代码，按下面的顺序过一遍，大部分问题五分钟内能定位：
- 先看返回体：错误响应里带着 HTTP 状态码和错误信息，先确认是哪一类；
- 401 时检查 API Key：请求头应为 Authorization: Bearer 加完整 Key。复制时多出的空格和换行是重灾区；Key 被删除后立即失效，只能重新创建；
- 402 时查余额：登录开放平台看可用余额，不足就先充值再重试；
- 核对模型名：当前的模型名是 deepseek-flash 和 deepseek-v4-pro。deepseek-chat、deepseek-reasoner 已于 2026 年 7 月 24 日停止使用，再调用这两个名字会失败；
- 500 和 503 时等待重试：这两类是服务端的问题，改代码没用，稍后再试。
一个常见误区：API Key 只能在开放平台的 API Keys 页面创建，网页版账号和登录密码都不是 Key，填进去必然报 401。
DeepSeek API错误码速查表
下面 7 类错误码来自官方文档的错误码页，截至 2026 年 9 月核查有效：
| | | |
|---|
| | | |
| | | 检查 API key 是否正确；没有 key 先创建 |
| | | |
| | | |
| | | |
| | | |
| | | |
与 429 直接相关的是并发限制。一个请求从发出到响应完成记为一个并发，两档模型的上限分别是：
并发限制以账号粒度计算，与 API Key 无关。换句话说，换一个 Key 绕不开限流，超了限度照样收到 429。
与报错相关的计费与限流规则
402 和 429 是两类典型的"代码没动却报错"，触发逻辑都藏在计费和限流规则里：
- 计费按 token 不按次数。扣减费用 = token 消耗量 × 模型单价，输入输出合并计量。调用次数没变、费用涨了，多半是单次对话的上下文变长；
- 余额扣减有顺序。充值余额和赠送余额同时存在时，优先扣赠送余额；
- 查余额可以走接口。GET /user/balance 返回的 granted_balance 是未过期的赠金余额，topped_up_balance 是充值余额，报 402 之前先看这两个字段；
- 429 按账号累计。并发和速率都以账号为单位，有更高并发需求可以提交工单申请扩容，官方说明扩容不额外收费。
两档模型的官方价格如下，单位为元/百万 tokens，格式是空闲时段/高峰时段：
高峰时段是北京时间周一至周五（不含中国法定节假日）的 9:00-12:00 和 14:00-18:00，其余时段（含周末和节假日全天）都是空闲时段，价格是高峰的一半。批量任务挪到空闲时段跑，费用直接减半，撞上 429 的概率也小得多。
DeepSeek API高频报错场景处理
速查表回答"是什么"，这一节回答"为什么总是撞上"：
- 401 反复出现：三个高频原因，复制 Key 时混入空格或换行、把网页版账号密码当成 Key、Key 已被删除。官方对 Key 保管的建议是不要与他人共享，也不要暴露在浏览器或其他客户端代码中；
- 402 充值后仍报错：确认开放平台显示的可用余额，而不是充值记录。账号里有赠送余额时优先扣赠送部分，充值到账后重试即可；
- 旧模型名不报错但换了芯：deepseek-v4-flash、deepseek-v4-flash-vision-exp 两个旧名仍可调用，不会报错，但请求实际由 DeepSeek-V4.1-Flash 提供服务，按 Flash 价格计费。查账单发现"模型不对"时先检查这里；
- keep-alive 不是报错：等待推理期间，非流式请求会持续收到空行，流式请求会收到 SSE keep-alive 注释，都不影响响应解析。10 分钟后仍未开始推理，服务器才会关闭连接；
- Key 泄漏的处理：登录开放平台，在 API Keys 页选中泄漏的 Key 点「回收箱」删除，看到"API Key 已删除"提示即已失效，然后创建新 Key 替换到应用里。
DeepSeek API报错常见问题
Q：调用 DeepSeek API 免费吗？
A：API 按量计费，费用等于 token 消耗量乘以模型单价，与网页版的免费对话是两套体系。新账号有没有赠送额度，官方文档没有公示，注册后调用 GET /user/balance，granted_balance 字段会直接给出答案。
Q：DeepSeek API报错去哪里查官方说明？
A：文档站的错误码页（api-docs.deepseek.com/zh-cn/quick_start/error_codes）列出了全部 7 类错误码的原因与解决方法，限流细节看同目录的「限速与隔离」页。
Q：DeepSeek API 兼容哪些 SDK？
A：兼容 OpenAI 和 Anthropic 两种格式。OpenAI 格式的 base_url 填 https://api.deepseek.com，Anthropic 格式填 https://api.deepseek.com/anthropic，都可以直接用对应 SDK 访问。
Q：401 报错最常见的原因是什么？
A：API Key 错误，包括复制不完整、混入空格换行、使用已删除的 Key。Key 删除后立即失效，只能重新创建。
Q：明明有余额为什么还报 402？
A：402 的触发条件是账号可用余额不足。计费按输入输出 token 总量而不是调用次数，长上下文对话消耗更快，先确认开放平台显示的可用余额再重试。
Q：429 报错怎么解决？扩容收费吗？
A：降低请求速率或并发，批量任务错峰到空闲时段执行。并发限制按账号计算，与 Key 无关；有更高需求可提交工单申请扩容，官方说明扩容不额外收费。
Q：旧模型名还能继续调用吗？
A：deepseek-chat 和 deepseek-reasoner 已于 2026 年 7 月 24 日停止使用。deepseek-v4-flash、deepseek-v4-flash-vision-exp 仍可调用，但实际由 V4.1-Flash 提供服务，按 Flash 价格计费。
Q：API Key 泄漏了怎么办？
A：立即登录开放平台，在 API Keys 页删除泄漏的 Key，删除后立即失效，然后创建新 Key 替换到应用中。平时不要把 Key 暴露在浏览器或客户端代码里。
Q：500 或 503 一直报错怎么办？
A：这两类分别是服务器内部故障和负载过高，等待一段时间再重试即可。官方的处理建议是：若问题持续存在，通过官方渠道联系平台处理，不需要修改自己的代码。
错误码口径和价格会随官方更新调整，动手排查前在文档站错误码页确认当期说明即可。想持续跟进 DeepSeek API 报错相关的模型变动与价格调整，可以关注本站的 AI 工具栏目，有新变化我们会同步更新。
AI 速览
