DeepSeek API 報錯 400、402、429 怎麼辦：官方錯誤碼與常見觸發原因對照

本文根據 DeepSeek 官方 API 文檔整理，資料核對於 2026-10-24。錯誤碼和限制可能調整，以官方文檔為準。圖為本站整理的示意圖。

適用於誰

• 搜「deepseek api 報錯」「deepseek 402」「deepseek 429」「deepseek 400」的開發者；
• 在 Cursor、Cline、Cherry Studio 等工具裏填了 DeepSeek 的 Key，卻一直報錯的人；
• 想弄清「伺服器繁忙」和「餘額不足」到底差在哪的人。

結論先說

1. 官方錯誤碼頁一共列了 7 個：400 格式錯誤、401 認證失敗、402 餘額不足、422 參數錯誤、429 請求速率達到上限、500 伺服器故障、503 伺服器繁忙。
2. 402 就是餘額不足，不是限速也不是伺服器問題；429 是你自己的並發或頻率超了；500 / 503 才是伺服器那邊的問題，官方說等一等再試。
3. 400 的原因最雜，文檔裏明確寫了幾種會觸發的情形，見第三節。

圖：本站根據 DeepSeek 官方錯誤碼頁 整理的示意圖

一、錯誤碼對照表

二、402 與 429 怎麼處理

402：先去開放平台看餘額，充值方法見 /guides/deepseek-api-platform-balance-topup。注意充值餘額和贈送餘額是分開的，扣費時優先扣贈送餘額。

429：限速頁寫明，對每個帳號，並發限制是 deepseek-flash 2500、deepseek-v4-pro 500。要點：

• 從請求發出到模型響應完成之前，算一個並發；
• 並發按帳號計，和用了幾個 Key 無關；多開 Key 不會增加額度；
• 在限度內的請求都會得到響應，超過就收到 HTTP 429；
• 需要更高並發，可以提交官方的帳號擴容申請工單，官方說擴容不增加額外費用。

處理思路：給請求加隊列或限流，失敗後等待一會兒再重試，別立刻狂重試；批量任務放到空閒時段，價格也更低（見 /guides/deepseek-v4-pro-vs-flash-api-price）。如果你只是在聊天網頁看到「伺服器繁忙」，那是網頁端的提示，見 /guides/deepseek-server-busy。

另外，Search 和 Fetch 接口有自己的 QPS 限制（官方寫 Search 100、Fetch 25），超過也是 429，並且和模型並發互不佔用。

三、文檔裏明確會觸發 400 的情形

圖：本站根據 DeepSeek 官方各功能文檔整理的檢查清單示意圖

1. 思考模式 + 工具調用沒回傳 reasoning_content：官方思考模式文檔寫明，攜帶了 tools 參數的請求，在後續所有請求中必須完整回傳 reasoning_content，即使那一輪沒有真的調用工具；沒有正確回傳，API 會返回 400。最省事的做法是直接把上一次返回的 message 整個 append 回 messages；
2. 圖片放錯位置：圖像理解文檔寫明，圖片只能出現在 user 消息裏，system 或 assistant 消息攜帶圖片會返回 400；
3. Anthropic 接口裏用了不存在的模型名：以 claude 開頭的模型名會被映射（claude-opus 開頭映射到 deepseek-v4-pro，claude-haiku、claude-sonnet 開頭映射到 deepseek-flash），不以 claude 開頭的未知模型名返回 400；
4. Responses API 圖片字段衝突：同時傳 image_url 和 file_id，或兩個都不傳，都返回 400；
5. JSON 格式本身有問題：請求體不是合法 JSON、字段值類型不對，都屬於官方說的「請求體格式錯誤」。

JSON 輸出還有一點：官方說使用 JSON Output 時，API 有概率返回空的 content，建議修改提示詞來緩解；同時提示詞裏必須有「json」字樣並給出期望格式的樣例，max_tokens 要設得夠大，防止 JSON 被截斷。

四、請求「卡住」或一直返回空行

限速頁的「請求保活機制」寫明：請求發出後有時要等一會兒，這段時間 HTTP 連接會保持，並持續收到內容——非流式請求返回空行，流式請求返回 SSE 的 keep-alive 註釋（: keep-alive）。這些不影響 JSON 解析，但如果你自己解析響應，要處理這些空行或註釋。如果 10 分鐘後請求還沒開始推理，伺服器會關閉連接。 所以不是死機，是排隊；排得太久就會斷。

五、在第三方工具裏報錯怎麼辦

在 Cursor、Cline、Cherry Studio 等工具裏，工具會把 API 的錯誤原樣顯示或包裝一下。先對照狀態碼：401 多半是 Key 填錯或帶了空格；402 去充值；429 降低並發；400 先檢查模型名拼寫（deepseek-flash、deepseek-v4-pro）、Base URL 是否是 https://api.deepseek.com，以及工具是否在發送官方文檔不支持的內容。具體到各工具的設定，見本站對應教學。Key 的創建與保管見 /guides/deepseek-api-key。

常見問題

Q：500 和 503 要重試幾次？

官方只說等待後重試，沒有給次數。建議加指數退避，並設上限；一直不行就去官方狀態頁（status.deepseek.com）看看。

Q：Search / Fetch 接口也是這些錯誤碼嗎？

大體相同，另外有 403（Fetch 被安全策略拒絕）、404（Fetch 沒取到可用內容）、408（讀取請求體超時）、413（請求體太大）、504（下游超時）。官方說遇到 408、429 或 5xx 要等待後重試，遇到 402 先充值，其他 4xx 不修改請求就不要重試。

Q：Python 調用的完整示例在哪？

見 /guides/deepseek-api-python-quickstart。

想同時用 ChatGPT、Claude 等海外模型做對比？本站提供 AI 會員充值，ChatGPT 可看 Plus 充值。

參考資料

• DeepSeek API 文檔：錯誤碼 — https://api-docs.deepseek.com/zh-cn/quick_start/error_codes
• DeepSeek API 文檔：限速與隔離 — https://api-docs.deepseek.com/zh-cn/quick_start/rate_limit
• DeepSeek API 文檔：思考模式 — https://api-docs.deepseek.com/zh-cn/guides/thinking_mode
• DeepSeek API 文檔：JSON Output — https://api-docs.deepseek.com/zh-cn/guides/json_mode
• DeepSeek API 文檔：圖像理解 — https://api-docs.deepseek.com/zh-cn/guides/vision
• DeepSeek API 文檔：使用 Anthropic API — https://api-docs.deepseek.com/zh-cn/guides/anthropic_api
• DeepSeek API 文檔：網頁搜尋與抓取 — https://api-docs.deepseek.com/zh-cn/guides/search