DeepSeekガイド
DeepSeek APIのエラーコードと対処
DeepSeek APIが返すエラーは、400・401・402・422・429・500・503の7種類です。公式の「Error Codes」の表(2026年11月11日確認)に、原因の切り分けの順番とリトライのコードを足して整理しました。
エラーコード一覧
| コード | 名前 | 主な原因 | 直し方 |
|---|---|---|---|
| 400 | Invalid Format | リクエストの形式が正しくない | エラーメッセージのヒントに沿ってリクエストの本文を直す |
| 401 | Authentication Fails | APIキーが違う | キーを確認する。無ければ作成する |
| 402 | Insufficient Balance | 残高が足りない | 残高を確認し、チャージする |
| 422 | Invalid Parameters | パラメータの値が正しくない | メッセージのヒントに沿ってパラメータを直す |
| 429 | Rate Limit Reached | 短時間に送りすぎ、または同時接続の上限超え | 送る間隔をあける。上限は deepseek-flash 2,500・v4-pro 500 |
| 500 | Server Error | サーバー側の問題 | 少し待って再送し、続く場合は公式に連絡 |
| 503 | Server Overloaded | アクセス集中でサーバーが混雑 | 少し待って再送する |
原因の切り分け:この順に見る
- コードが4xxか5xxか見る。4xxは自分側(キー・残高・送り方)、5xxはサーバー側です。
- 401なら、キーの前後に空白や改行が入っていないか、環境変数が読めているか(print で先頭数文字だけ確認)を調べます。キー全体を画面やログに出さないでください。
- 402なら、公式の画面で残高を見ます。無料枠の残高が先に使われる仕組みなので、付与分が切れて有料の残高が0になっている場合があります。
- 400・422なら、モデル名(deepseek-flash)、messagesの形、思考モードのパラメータ(OpenAI SDKでは extra_body に入れる)を見直します。
- 429なら、並列で送っている数を数えます。リクエストは「送ってから回答が完了するまで」が1本の接続として数えられます。
- 500・503なら、数十秒あけて再送します。ピーク時間帯(日本時間の平日10〜13時・15〜19時)に混みやすいかは公式に記載がないため、自分のログで時間帯を記録して傾向を見てください。
リトライのコード例(Python)
import os, time, random
from openai import OpenAI, APIStatusError
client = OpenAI(api_key=os.environ["DEEPSEEK_API_KEY"], base_url="https://api.deepseek.com")
def ask(text, retries=4):
for i in range(retries):
try:
r = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": text}],
extra_body={"thinking": {"type": "disabled"}},
)
return r.choices[0].message.content
except APIStatusError as e:
# 429・500・503 だけ待って再送する。401・402・400・422 は直さない限り何度やっても同じ
if e.status_code in (429, 500, 503) and i < retries - 1:
time.sleep(2 ** i + random.random()) # 1秒・2秒・4秒…とあける
continue
raise401・402・400・422は、同じリクエストを再送しても結果が変わりません。再送してよいのは429・500・503だけです。
ログに残すと後で役に立つもの
- エラーコードとメッセージ、日時(日本時間とUTCの両方)
- 使ったモデル名、思考モードの設定、入力の文字数
- 成功した回答の usage(入力・出力のトークン数):料金計算の見積もりと実測の差を確かめられます
キー、個人情報、顧客のデータはログに残さないでください。
確認した公式資料
上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。
あわせて読むページ
よくある質問
429が出たらどうすればいいですか?
送る間隔をあけるか、並列の数を減らします。公式の説明では、同時接続の上限(deepseek-flashは2,500、deepseek-v4-proは500)を超えると429になります。
402が出る理由は?
残高が尽きたときのエラーです。公式の画面で残高を確認し、チャージします。
500や503は自分のコードのせいですか?
いいえ、サーバー側の問題です。少し待って再送し、続くようなら公式に連絡してください。