DeepSeek V4 migration は、もはや単なるモデルアップグレードではなく、期限に追われるクリーンアップ作業です。DeepSeek の公式 API ドキュメントによると、旧来の deepseek-chat と deepseek-reasoner のエイリアスは 2026年7月24日 15:59 UTC 以降、完全に廃止されアクセスできなくなります。サポートされている V4 のモデル ID は deepseek-v4-flash と deepseek-v4-pro です。
朗報として、多くのチームにとってこれは制御された設定変更で済むはずです。DeepSeek は、同じ直接の base_url を維持し、モデル名を更新するよう案内しています。モデルを Flatkey 経由でルーティングしている場合も考え方は同じです。アプリの接続先を https://router.flatkey.ai/v1 のままにし、エイリアスを現在の Flatkey DeepSeek V4 のモデル行に置き換え、本番トラフィックを移す前にレスポンス挙動、thinking モード、使用ログ、料金、ロールバックを確認してください。
この DeepSeek V4 migration チェックリストでは、具体的な手順を示します。旧エイリアスの対応付け、deepseek-v4-flash または deepseek-v4-pro の選択、thinking と non-thinking の挙動テスト、SDK 設定の更新、そして切替期限直前の未確認のモデル変更を避けることです。
DeepSeek V4 移行で何が変わるか：クイックアンサー
緊急の変更点はモデル文字列です。本番コード、環境変数、プロンプトルーター、評価ジョブ、フォールバックポリシーを deepseek-chat や deepseek-reasoner にハードコードしたままにしないでください。
| 旧エイリアス | 現在の公式な挙動 | テストする移行先 | 確認すべきリスク |
|---|---|---|---|
deepseek-chat |
現在は deepseek-v4-flash の非思考モードにルーティングされます |
意図的に別の V4 モードを選ばない限り、思考を無効にした deepseek-v4-flash |
出力スタイル、レイテンシ、コスト、パーサー互換性、および無視されるパラメータ |
deepseek-reasoner |
現在は deepseek-v4-flash の思考モードにルーティングされます |
思考を明示的にテストした deepseek-v4-flash または deepseek-v4-pro |
reasoning_content、トークン使用量、マルチターン処理、SDK サポート |
| DeepSeek Anthropic API における Claude शैलीのモデル名 | DeepSeek は Claude Opus の名前を V4 Pro に、Claude Haiku/Sonnet の名前を V4 Flash にマッピングします | ルーティング層で許可されているなら、明示的な DeepSeek V4 のモデル ID を優先してください | 未対応の Anthropic フィールド、画像/ドキュメントコンテンツのサポート、ツールコールの挙動 |
DeepSeek への直接呼び出しでは、公式の OpenAI 形式のベース URL は引き続き https://api.deepseek.com です。Flatkey では、ルーターベース URL は引き続き https://router.flatkey.ai/v1 です。どちらの経路でも、DeepSeek V4 移行 は検索置換だけでなく、モデルと挙動の変更としてテストする必要があります。
エイリアスの期限が重要な理由
DeepSeek の V4 プレビューページには、API は現在利用可能であり、deepseek-v4-pro と deepseek-v4-flash の両方が 1M コンテキストと thinking / non-thinking の両モードをサポートし、古いエイリアスは 2026 年 7 月 24 日 15:59 UTC 以降に廃止されると記載されています。つまり、古いエイリアスは、廃止期間を過ぎると「今日までは動く」から「完全に失敗する」へと変わり得ます。
ホームページのクイックスタート表でも、deepseek-chat と deepseek-reasoner が 2026/07/24 に非推奨となるエイリアスとして挙げられています。また、互換性のため、これらのエイリアスは deepseek-v4-flash の non-thinking モードと thinking モードに対応すると記載されています。
この互換性の詳細は役立ちますが、待つ理由にはなりません。きちんとした DeepSeek V4 migration を行えば、出力の比較、実行手順書の更新、サポートチームの教育、そして期限前に本番ダッシュボードへ新しいモデル ID が表示されることの確認に十分な時間を確保できます。
Direct DeepSeek と Flatkey ルーティングの比較
一般的な移行パスは 2 つあります。
| 判断項目 | Direct DeepSeek API | Flatkey 経由の DeepSeek |
|---|---|---|
| Base URL | https://api.deepseek.com |
https://router.flatkey.ai/v1 |
| API key | DeepSeek API key | Flatkey API key |
| Model selection | Official DeepSeek model ID | Current Flatkey DeepSeek model row |
| Primary benefit | Provider-direct setup | One key, one router, shared usage logs, quotas, and billing visibility across providers |
| Production check | DeepSeek response, thinking mode, pricing, and errors | Response, route status, selected model row, usage log, pricing unit, quota, and rollback |
Flatkey の公開プロダクト説明では、このプラットフォームは 1 つの API key、OpenAI 互換の base URL、明確な pricing、統合された billing、そして keys、usage、routing を管理する 1 つの dashboard を中心に位置付けられています。GPT、Claude、Gemini、Qwen、MiniMax、DeepSeek のトラフィックをすでに 1 つの gateway 経由で動かしているチームにとって、DeepSeek V4 migration は、スタック全体で model IDs と logging を標準化するよい機会です。
Flatkey DeepSeek V4 のカタログチェック
この記事では、2026年6月16日に Flatkey の公開価格 API を確認しました。スナップショットでは、合計638件のモデル行と、DeepSeek名を含む19件の行が返されました。deepseek-v4-pro と deepseek-v4-flash の両方が、openai エンドポイント対応の Standard グループに掲載されていました。
これは、あなたのアカウントとルートが準備できていることを約束するものではなく、日付のあるカタログ上の証拠として扱ってください。同じスナップショットでは、両方のV4行の可用性ステータスが unknown_failure でした。つまり、実際のトラフィックをそのルートに依存させる前に、現在の Flatkey pricing の表示またはダッシュボードで可用性を確認する必要があります。慎重な DeepSeek V4 migration では、切り替え当日にライブのスモークテストと使用ログの確認を含めるべきです。
DeepSeek V4 移行チェックリスト
本番環境でエイリアスを置き換える前に、このチェックリストを使用してください。
- すべてのエイリアスを棚卸しする。 アプリケーションコード、環境変数、プロンプトルータールール、eval 設定、バックグラウンドジョブ、ノートブック、ドキュメント、サポートランブックから
deepseek-chatとdeepseek-reasonerを検索します。 - 各ワークロードを分類する。 各ルートを chat、reasoning、agent のツール使用、構造化出力、長文コンテキスト、バッチ eval、または fallback-only としてマークします。すべてのルートを同じ V4 モードに移行すべきだと決めつけないでください。
- 対象モデルを選ぶ。 現在のエイリアスに最も近い代替を求めるなら、まず
deepseek-v4-flashから始めます。テスト後にコストとレイテンシーの特性を受け入れられるなら、ワークロードにより高い能力が必要な場合にdeepseek-v4-proを評価します。 - thinking を明示する。 旧
deepseek-chatの挙動については、非 thinking モードをテストします。旧deepseek-reasonerの挙動については、thinking モードをテストし、SDK がreasoning_contentをどのように扱うか確認します。 - モデル ID は設定に保持する。 対象モデルは、アプリケーションロジックに直書きせず、環境変数またはルーティングテーブルに入れます。
- 出力のペアテストを実施する。 代表的なプロンプト、パーサー、JSON モードのタスク、ツール呼び出し、拒否/エラーケースで、旧エイリアスの応答と新しい V4 の応答を比較します。
- ストリーミングと使用量の計上を確認する。 最終的な使用量が、課金または可観測性のコードが想定する場所に表示されるか確認します。特にストリーミング応答では重要です。
- コストとクォータを確認する。 プロバイダーの価格または Flatkey の価格を確認し、本番トラフィックが増える前に低いクォータまたはテスト用予算を設定します。
- 新しいモデル ID をログに記録する。 トレース、アラート、課金エクスポートに、一般的なプロバイダーレーベルだけでなく
deepseek-v4-flashまたはdeepseek-v4-proが表示されるようにします。 - ロールバックを準備する。 V4 ルートが実際のワークロードテストを通過するまで、以前のプロバイダーまたはフォールバックモデルを設定したままにします。
- 古いドキュメントを削除する。 社内のセットアップガイドを更新し、新しい開発者が廃止済みのエイリアスを本番に戻してしまわないようにします。
Flatkey 用の設定テンプレート
テンプレートのみ: これは、有効な Flatkey キーと、現在のカタログから確認済みの Flatkey DeepSeek V4 モデル ID を使って実行してください。形は通常の OpenAI SDK の使い方ですが、ルート、モデルの状態、thinking の挙動、使用量ログはまだテストが必要です。
FLATKEY_API_KEY="sk-fk-your-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_DEEPSEEK_MODEL="deepseek-v4-flash"
# ロールアウト中もターゲットを変更しやすくしておきます。
# DeepSeek を直接比較する場合:
DEEPSEEK_BASE_URL="https://api.deepseek.com"import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url=os.environ.get("OPENAI_BASE_URL", "https://router.flatkey.ai/v1"),
)
response = client.chat.completions.create(
model=os.environ.get("FLATKEY_DEEPSEEK_MODEL", "deepseek-v4-flash"),
messages=[
{
"role": "user",
"content": "DeepSeek V4 のルートが設定されていることを、1文で確認して返信してください。",
}
],
)
print(response.choices[0].message.content)
print(response.usage)DeepSeek を直接テストする場合は、thinking モードについて DeepSeek 公式の OpenAI SDK の例に従ってください。thinking ガイドによると、thinking トグルはデフォルトで有効になっており、OpenAI 形式の effort パラメータは high と max をサポートし、低い effort ラベルは互換性のために上位へマッピングされます。アプリが non-thinking 応答に依存している場合は、エイリアスに頼らず、その選択を明示してテストしてください。
切り替え前のテストマトリクス
DeepSeek V4 migration は、実際に製品で使用している挙動をテストした後にのみ承認すべきです。
| テスト | 確認内容 | 合格の兆候 |
|---|---|---|
| 基本チャット | シンプルなプロンプト、応答の形状、パーサーの挙動 | アプリがスキーマやロールのエラーなしに期待どおりの内容を受け取る |
| Thinking mode | thinking、reasoning_effort、reasoning_content |
推論出力が、製品ポリシーに従って処理されるか、意図的に抑制される |
| ストリーミング | チャンク形式、最終 usage、タイムアウト時の挙動 | クライアントのパーサーと課金フックが引き続き機能する |
| ツール呼び出し | ツールスキーマ、引数、マルチステップのエージェントターン | ツール呼び出しが、JSON の不正や ID 欠落なしに生成・消費される |
| 構造化出力 | JSON モードのプロンプトとバリデーション | バリデーターの合格率が、リリース基準のしきい値内に収まる |
| 長いコンテキスト | 大きなプロンプト、トランケーション、キャッシュ前提 | コンテキストの処理が予測可能で、コストも許容範囲である |
| Flatkey observability | ルートのステータス、モデル ID、トークン使用量、コスト、エラーログ | ダッシュボードのエントリが送信したリクエストと一致する |
| ロールバック | 前のプロバイダーまたはフォールバックモデル | デプロイなしで設定によりトラフィックを戻せる |
よくあるミス
- DeepSeek V4 migration を、出力評価なしで一括検索・置換として扱ってしまう。
deepseek-reasonerを置き換えたのに、マルチターン会話でreasoning_contentのテストを忘れてしまう。- 本番コードでは V4 の ID を使っているのに、eval ジョブ、サポート用のサンプル、フォールバックルールにエイリアスを残したままにしてしまう。
- ルートのステータスや使用ログを確認せずに、DeepSeek 直結とルーティングされた Flatkey の挙動が同一だと決めつけてしまう。
- 最新の Flatkey の料金ページやダッシュボードではなく、古い記事からモデル ID をコピーしてしまう。
- 最初のスモークテストで通常の回答が返ってきたからといって、コスト確認を省略してしまう。
- 2026年7月24日まで待ってから、スケジュール済みジョブやバックグラウンドワーカーがまだアクセス不能なエイリアスを使っていることに気づく。
他の Flatkey 移行ガイドとの関連
まだプロバイダー設定を一元化していない場合は、より広範な OpenAI互換 API 移行 ガイドから始めてください。これは、DeepSeek を超えて適用されるベース URL の変更、スモークテスト、ロールバックパターンをカバーしています。
DeepSeek を直接ルーティングするか、1つのゲートウェイ経由にするかまだ決めていない場合は、このページを既存の DeepSeek API アクセス ガイドと比較してください。予算管理とモデル行の確認には、AI モデル価格比較 ワークフローと現在の Flatkey 料金 ページを使用してください。
よくある質問
deepseek-chat と deepseek-reasoner はいつ廃止されますか？
DeepSeek の公式ドキュメントでは、2026年7月24日 15:59 UTC が終了時刻として記載されており、その後は deepseek-chat と deepseek-reasoner にアクセスできなくなります。その日付までに DeepSeek V4 への移行 を計画してください。
deepseek-chat の代替は何ですか？
最も近い動作を確認するには、非思考動作で deepseek-v4-flash をテストしてください。DeepSeek によると、deepseek-chat は現在 deepseek-v4-flash の非思考モードにルーティングされています。
deepseek-reasoner の代替は何ですか？
品質、コスト、レイテンシ要件に応じて、思考を有効にした deepseek-v4-flash または deepseek-v4-pro をテストしてください。DeepSeek によると、deepseek-reasoner は現在 deepseek-v4-flash の思考モードにルーティングされています。
DeepSeek のベース URL を変更する必要がありますか？
DeepSeek OpenAI 形式の直接呼び出しでは、公式のベース URL は https://api.deepseek.com のままです。Flatkey の呼び出しでは、https://router.flatkey.ai/v1 と Flatkey API キーを使用してください。
Flatkey は DeepSeek V4 をサポートしていますか？
2026年6月16日時点の Flatkey の料金 API スナップショットには、deepseek-v4-pro と deepseek-v4-flash が openai エンドポイント対応として記載されていました。同じスナップショットでは、これらの行に unknown_failure の利用可能ステータスが示されていたため、本番トラフィックの前に、現在の料金ページ、ダッシュボードのルートステータス、およびライブのスモークテストを確認してください。
deepseek-v4-flash と deepseek-v4-pro のどちらを選ぶべきですか？
旧エイリアスとの互換性のため、最初の代替候補として deepseek-v4-flash を使用してください。ワークロードにより強い推論やエージェント機能が必要で、レイテンシとコストの確認に問題がない場合は deepseek-v4-pro をテストしてください。
本番トラフィックを切り替える前に料金を確認する
DeepSeek V4 migration は、非推奨のエイリアスを削除し、思考動作を明示し、モデル選択を設定の背後に置くのに最適なタイミングです。ロールアウト前に、現在の Flatkey のモデル行、ルート状態、使用ログ、および deepseek-v4-flash または deepseek-v4-pro の料金を確認してください。
料金を表示して、本番トラフィックを移す前に現在の Flatkey DeepSeek V4 の行を確認してください。
