DeepSeek API 移行ガイド：V4.1 Flash への移行手順

アプリケーションが依然として deepseek-v4-flash を送信している場合、リクエストが成功しても元の V4 Flash モデルが使用されているとは限りません。DeepSeek の現在のドキュメントでは、その互換性名は V4.1 Flash にルーティングされます。新しい統合では deepseek-flash を明示的に要求してください。

本ガイドは 2026 年 9 月 23 日時点の公式 API 移行パスを更新するものです。スクリプト、サーバー、またはエージェント統合を維持している開発者向けです。Web チャット製品間での会話の移動は別のタスクであり、チャット履歴をコピーしてもアプリケーション内の API 設定は変更されません。

各識別子の現在の意味を確認する

公式変更ログおよびモデル表により、現在のマッピングが確立されています。

設定内の識別子	現在の公式ステータス	推奨アクション
`deepseek-flash`	V4.1 Flash	新しい Flash 統合に使用
`deepseek-v4-flash`	V4.1 Flash の互換性エイリアス	保守中のサンプルと設定を更新
`deepseek-v4-flash-vision-exp`	V4.1 Flash の互換性エイリアス	画像リクエストを `deepseek-flash` に移行
`deepseek-v4-pro`	V4 Pro は利用可能のまま	確立されたワークフローを変更する前に評価
`deepseek-chat` / `deepseek-reasoner`	2026 年 7 月 24 日に公式に廃止予定	継続的な受け入れに依存せず移行

従来の chat および reasoner 名は、非思考動作と思考動作を選択する長期的な方法として扱わないでください。維持されたコードでは、モデルの選択と考え設定を明示的にしてください。また、定期ジョブとバックグラウンドワーカーも検査してください。インタラクティブなアプリケーションを変更しても、他のサービスにコピーされたモデル名は更新されません。

プロバイダーとモデルを分離する

アプリケーションが消費するエンドポイント、要求されたモデル名、リクエスト形式、およびレスポンスフィールドを記録してください。サードパーティゲートウェイは異なるエイリアスや価格を使用する場合があります。上記のマッピングは DeepSeek の公式サービスについて説明しており、DeepSeek モデルを提供するすべてのサービスについて説明しているわけではありません。

例えば、環境変数 MODEL=deepseek-v4-flash は物語の一部しか telling しません。ベース URL と、アプリケーションメッセージを API リクエストに変換するコードも必要です。アダプターは、基盤となるモデルがより多くをサポートしていても、フィールドを削除したり、より小さな出力制限を課したりする可能性があります。

編集前に設定ファイル、デプロイメント変数、プロンプト評価スクリプトを検索してください。最初の移行チェックではプロバイダーを変更せずに維持してください。プロバイダー、プロトコル、プロンプト、モデルを一度に変更すると、失敗した結果の診断がはるかに困難になります。

Start using DeepSeek-V4

明示的なモードで小さなリクエストを作成する

次の Python 例は、OpenAI 互換クライアントを使用して公式 Chat Completions エンドポイントを呼び出します。テスト環境に openai パッケージをインストールし、通常のシークレット管理メカニズムを通じて DEEPSEEK_API_KEY を提供してください。キーをソースファイル、ブラウザコード、およびリクエストログから除外してください。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{
        "role": "user",
        "content": "Extract the order ID from: Order A-104 is ready. Return only the ID.",
    }],
    max_tokens=128,
    extra_body={"thinking": {"type": "disabled"}},
)

print(response.choices[0].message.content)
print(response.usage)

このタスクには明確な预期答え A-104 があります。複雑なプロンプトなしで、認証、ルーティング、レスポンス解析、および使用量報告をチェックします。これはドキュメントベースの例であり、記録されたライブ API テストではありません。予期しない答えまたはエラーは、フルアプリケーションコンテキストを追加する前にリクエストを検査する理由となります。

128 トークンのキャップは、この小さな非思考タスクに適しています。推論やエージェントワークの推奨予算ではありません。実際のワークロードを復元する際は、要求された出力を許可する予算を選択し、完了の終了理由を切り捨てについてチェックしてください。

思考設定はエラーなしで動作を変更する可能性がある

思考モードドキュメントによると、思考はデフォルトで高努力で有効になっています。Chat Completions では、Python クライアントを使用する場合、thinking は extra_body を通じて供給されます。サポートされている努力レベルは low、high、max です。

思考モードの試行には、関連する引数を以下に置き換えてください。

reasoning_effort="high",
extra_body={"thinking": {"type": "enabled"}},

HTTP レスポンスが成功したからといって、すべてのサンプリング設定が適用されたとは仮定しないでください。ドキュメントによると、temperature は思考モードでは効果がないとされています。互換性のために受け入れられる場合でもそうです。古いテストスイートが温度を使用して変動を制御していた場合、結果を比較する前にその違いを文書化してください。

ツール呼び出し履歴は特別な注意が必要です。tools を運ぶ Chat Completions リクエストの場合、ガイドでは以前の reasoning_content を返すことを要求しています。ツール呼び出しのないターンを含みます。アシスタントの最終テキストのみを保持するアダプターは、後のターンを破損させる可能性があります。最初のレスポンスのみを検証するのではなく、マルチターンテストでの完全なメッセージ処理を検査してください。

失敗ケースを中心に回帰テストセットを構築する

预期結果がすでにわかっている例から始めます。 missing field を含む抽出、スキーマに適合しなければならないレスポンス、答えが終盤にある長い入力、およびツール結果後に継続するツールワークフローを含めます。アプリケーションが画像を使用している場合のみ、画像ケースを追加してください。

各タスクについて、レイテンシを測定する前に出力が使用可能かどうかを確認してください。JSON のような答えでも、解析とスキーマ検証が必要です。コード変更でも関連テストが必要です。引用された値でも、提供された資料に存在する必要があります。出力形式の回帰とプロバイダーエラーを区別できるように、失敗カテゴリを保存してください。

再試行を含む完了した作業を測定してください。入力、出力、およびキャッシュ使用量を別々に記録してください。新しい動作がより長い答えを生成したり、アプリケーションに再試行をさせたりする場合、価格低下がより安いタスクを保証するわけではありません。比較には同一のプロンプトと明示的な設定を使用してください。プロンプト最適化は後のパスのために残してください。

Pro の可用性とロールバックは別途判断が必要

9 月 10 日の発表では、Pro リクエストを Flash にルーティングする計画が説明されました。現在の変更ログでは、Pro サービスは請求方法を変更せずに 9 月 14 日以降も継続すると記載されています。古い廃止計画を読んだからといって、動作している Pro 統合を移行しないでください。

Flash の場合、設定を deepseek-v4-flash に戻しても廃止されたモデルは復元されません。その識別子は新しいモデルのエイリアスです。ロールバック計画は、実際に利用可能なサービスを指名し、その機能を考慮する必要があります。Pro は画像リクエストのドロップインフォールバックではありません。現在の公式モデル表には Pro のビジョンサポートがリストされていません。

まずトラフィックの小さな部分に変更をロールアウトし、停止するための明確な条件を設けてください。評価結果とプロバイダー設定をリリース記録と共に保持してください。新しいルートがアプリケーションのチェックに合格したら、コピーされた例と内部ドキュメントを更新し、次の統合中に旧識別子が戻らないようにしてください。