ホーム › APIの始め方 › エラーコード

DeepSeekガイド

DeepSeek APIのエラーコードと対処

DeepSeek APIが返すエラーは、400・401・402・422・429・500・503の7種類です。公式の「Error Codes」の表(2026年11月11日確認)に、原因の切り分けの順番とリトライのコードを足して整理しました。

確認・更新 

エラーコード一覧

コード名前主な原因直し方
400Invalid Formatリクエストの形式が正しくないエラーメッセージのヒントに沿ってリクエストの本文を直す
401Authentication FailsAPIキーが違うキーを確認する。無ければ作成する
402Insufficient Balance残高が足りない残高を確認し、チャージする
422Invalid Parametersパラメータの値が正しくないメッセージのヒントに沿ってパラメータを直す
429Rate Limit Reached短時間に送りすぎ、または同時接続の上限超え送る間隔をあける。上限は deepseek-flash 2,500・v4-pro 500
500Server Errorサーバー側の問題少し待って再送し、続く場合は公式に連絡
503Server Overloadedアクセス集中でサーバーが混雑少し待って再送する

原因の切り分け:この順に見る

  1. コードが4xxか5xxか見る。4xxは自分側(キー・残高・送り方)、5xxはサーバー側です。
  2. 401なら、キーの前後に空白や改行が入っていないか、環境変数が読めているか(print で先頭数文字だけ確認)を調べます。キー全体を画面やログに出さないでください。
  3. 402なら、公式の画面で残高を見ます。無料枠の残高が先に使われる仕組みなので、付与分が切れて有料の残高が0になっている場合があります。
  4. 400・422なら、モデル名(deepseek-flash)、messagesの形、思考モードのパラメータ(OpenAI SDKでは extra_body に入れる)を見直します。
  5. 429なら、並列で送っている数を数えます。リクエストは「送ってから回答が完了するまで」が1本の接続として数えられます。
  6. 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
            raise

401・402・400・422は、同じリクエストを再送しても結果が変わりません。再送してよいのは429・500・503だけです。

ログに残すと後で役に立つもの

  • エラーコードとメッセージ、日時(日本時間とUTCの両方)
  • 使ったモデル名、思考モードの設定、入力の文字数
  • 成功した回答の usage(入力・出力のトークン数):料金計算の見積もりと実測の差を確かめられます

キー、個人情報、顧客のデータはログに残さないでください。

確認した公式資料

上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。

あわせて読むページ

よくある質問

429が出たらどうすればいいですか?

送る間隔をあけるか、並列の数を減らします。公式の説明では、同時接続の上限(deepseek-flashは2,500、deepseek-v4-proは500)を超えると429になります。

402が出る理由は?

残高が尽きたときのエラーです。公式の画面で残高を確認し、チャージします。

500や503は自分のコードのせいですか?

いいえ、サーバー側の問題です。少し待って再送し、続くようなら公式に連絡してください。