DeepSeek V4 移行チェックリスト：非推奨エイリアスを安全に置き換える

DeepSeek V4 の移行は、もはや一般的な「V4 へアップグレード」作業ではありません。2026年9月16日時点では、移行リスクは具体的です。DeepSeek によると、従来名の deepseek-v4-flash と deepseek-v4-flash-vision-exp は互換性のために引き続き受け付けられますが、これらの終了したモデル名は DeepSeek-V4.1-Flash によって提供され、Flash 価格で課金されます。また DeepSeek は、deepseek-v4-pro の API サービスは 2026年9月14日以降も継続し、DeepSeek から追加通知がない限り既存の課金方法が適用されるとも述べています。

つまり、安全な道筋は、過去のすべてのエイリアスを追いかけることではありません。新規開発は deepseek-flash に標準化し、deepseek-v4-pro を意図的に使い続けている箇所を文書化し、製品が実際に呼び出している正確なルートを確認することです。Flatkey 経由でルーティングする場合も原則は同じです。OpenAI 互換クライアントの接続先を https://router.flatkey.ai/v1 に維持し、ライブカタログから現在の DeepSeek の行を選び、スモークテストを実行し、本番トラフィックを移す前に使用ログを確認してください。

この DeepSeek V4 移行チェックリスト：非推奨エイリアスを安全に置き換える ガイドでは、個人開発者や小規模な AI 製品チーム向けに、非推奨エイリアスの監査、モデル ID の更新、thinking モードのテスト、Responses API と tool-call の挙動検証、課金単位の確認、そしてロールバックを簡単に保つための実践的な移行手順を示します。

クイックアンサー：何を変更すべきか？

現在の Flash モデル名として deepseek-flash を使ってください。deepseek-v4-flash と deepseek-v4-flash-vision-exp は互換性エイリアスとして扱い、新しいコード、ルーティングポリシー、ドキュメント、評価シートから削除すべきです。deepseek-v4-pro は、Pro ルートを直接テストおよび監視する理由がある場合にのみ残してください。

実務上のDeepSeek V4 移行のルールはシンプルです。エイリアスは新規の本番設定ではなく、監査レポートに残すものです。

この移行が6月のチェックリストと異なる理由

この記事の元の版では、deepseek-chat と deepseek-reasoner の2026年7月の廃止に焦点を当てていました。しかし、今ではそれがこのページにとって最も安全な前提ではありません。現在の公式 DeepSeek ドキュメントでは、V4.1 Flash のリリース、deepseek-flash というモデル名、廃止された Flash および Flash Vision のエイリアス、そして deepseek-v4-pro に関する API サービス継続の注記が強調されています。

小規模チームにとって、これは移行計画を変えます。DeepSeek 関連の記述をすべて慌てて書き換える必要はありません。必要なのは、日付付きの証跡を伴う制御されたエイリアス整理です。

• コード、環境変数、評価ジョブ、ドキュメントの中に、まだどのモデル文字列が残っているか？
• どの文字列が互換性のためのエイリアスで、どの文字列が現在のモデル ID か？
• どのルートが直接 DeepSeek ルートで、どのルートが Flatkey や別のゲートウェイを経由しているか？
• どのワークロードが、vision、thinking、Responses API、tool calls、structured output、long context、または streaming に依存しているか？
• どのダッシュボードが、新しいモデル ID が実際にトラフィックを処理していることを証明しているか？

それが、エイリアス置き換えと信頼できるDeepSeek V4 移行の違いです。

コードを編集する前に固定しておくべきソースの事実

モデル文字列を変更する前に、ソースの日付と確認した正確なページを含む短い移行メモを保存してください。この更新でのソースの事実は次のとおりです。

タイムスタンプなしで価格の数値をアプリケーションのドキュメントに貼り付けないでください。DeepSeek の現在の価格ページでは、価格が 100万トークンあたりで記載され、cache-hit 入力、cache-miss 入力、出力トークンが分けられており、ピーク／オフピークの時間帯も注記されています。これだけでも、移行スクリプト内の静的な見積もりに頼るのではなく、ロールアウト時に実際の価格を確認する十分な理由になります。

DeepSeek 直結と Flatkey ルーティングの比較

DeepSeek V4 移行 は、直接行うことも、Flatkey 経由でルーティングすることも、テスト中に両方行うこともできます。

Flatkey は、運用上の課題が 1 つの DeepSeek ルートよりも大きい場合に有用です。たとえば、分散した provider keys、繰り返し発生する SDK の編集、明確でないリクエスト単位のコスト、監査しづらい fallback の判断などです。しかし、ゲートウェイを使っても model ID の確認は不要にはなりません。アカウントが呼び出す正確な model row を必ずテストしてください。

DeepSeek V4 移行チェックリスト

本番環境で aliases を置き換える前に、このチェックリストを使用してください。

1. ソース日付を固定する。 DeepSeek のドキュメント、Flatkey のドキュメント、Flatkey モデルディレクトリ、価格、ルート状況を確認した日付を記録します。この記事の更新では、その日付は 2026 年 9 月 16 日です。
2. スタック全体を検索する。 deepseek-v4-flash、deepseek-v4-flash-vision-exp、deepseek-flash、deepseek-v4-pro、および開発者に古い値をコピーするよう指示している古いドキュメントを探します。
3. 各一致箇所を分類する。 本番コード、ステージング設定、評価ジョブ、プロンプトルーターポリシー、顧客向けドキュメント、サポート用マクロ、ノートブック、CI フィクスチャ、サンプルを分けて確認します。
4. 非推奨の Flash エイリアスを置き換える。 deepseek-v4-flash と deepseek-v4-flash-vision-exp は、テスト用ルートとロールバック計画を用意した後にのみ deepseek-flash へ移行します。
5. Pro は明示的に扱う。 deepseek-v4-pro のワークロードを Flash に黙って移さないでください。Pro を引き続き使用する場合は、所有者、理由、確認日、フォールバックモデルを記録します。
6. 思考モードを明示する。 DeepSeek のドキュメントでは、思考モードはデフォルトで有効で、デフォルトの effort は high だとされています。非思考の挙動が必要な場合は、意図的に設定してテストしてください。
7. vision エイリアスを使っていた場合は画像入力をテストする。 deepseek-v4-flash-vision-exp を使っていたワークロードについては、実際にリリースするルートで画像入力テストを実行します。
8. Responses API は別途テストする。 DeepSeek の Responses API 互換性には、サポート済み、部分的にサポート、無視、未対応のフィールドが含まれます。Chat Completions だけから動作を推測しないでください。
9. ツール呼び出しと構造化出力のテストを実行する。 ツールスキーマ、関数引数、JSON 解析、再試行、マルチターン動作を検証します。
10. ストリーミングと使用量を確認する。 チャンクの形状、タイムアウト処理、最終 usage、トークン数、および請求フィールドを、プロバイダーの直接ログまたは Flatkey Usage Logs で確認します。
11. ドキュメントとサンプルを更新する。 次回のオンボーディングやバグ修正時に非推奨エイリアスを再導入してしまう古いスニペットを削除します。
12. 設定の背後で段階的に展開する。 対象モデルは環境変数またはルーティングテーブルに入れます。ビジネスロジック内にハードコードされたリテラルは避けてください。
13. 最初の本番トラフィックを監視する。 低リスクのトラフィックから開始し、受理された出力率と受理応答 1 件あたりのコストを比較し、ログがきれいになってからのみ段階的に増やします。

コピー可能なエイリアス監査テンプレート

このテンプレートを短い移行記録として使用します。リポジトリ、課題トラッカー、またはランブックに保存しておくと、将来の修正時にエイリアスが変更された理由がわかります。

deepseek_v4_migration:
  checked_at_utc: "2026-09-16T00:00:00Z"
  source_pages:
    - "https://api-docs.deepseek.com/"
    - "https://api-docs.deepseek.com/quick_start/pricing"
    - "https://api-docs.deepseek.com/news/news260910"
    - "https://api-docs.deepseek.com/guides/thinking_mode"
    - "https://api-docs.deepseek.com/guides/responses_api"
    - "https://docs.flatkey.ai/quickstart.md"
    - "https://docs.flatkey.ai/guides/openai-sdk.md"
  replacements:
    - from: "deepseek-v4-flash"
      to: "deepseek-flash"
      reason: "レガシーな Flash エイリアス。互換性のために V4.1 Flash  द्वारा提供されるルート"
      owner: "engineering"
      status: "test_before_merge"
    - from: "deepseek-v4-flash-vision-exp"
      to: "deepseek-flash"
      reason: "レガシーな vision 実験用エイリアス。画像入力の動作を確認すること"
      owner: "engineering"
      status: "test_before_merge"
  intentionally_kept:
    - model: "deepseek-v4-pro"
      reason: "Pro ルートは引き続き意図的に評価される"
      next_review_date: "2026-09-30"
  required_tests:
    - plain_chat
    - thinking_enabled
    - thinking_disabled_if_used
    - responses_api
    - image_input_if_used
    - tool_calls
    - json_output
    - streaming
    - usage_log_readback
    - rollback

Flatkey 設定パターン

最も安全な Flatkey のセットアップでは、OpenAI 互換のクライアント表面を安定させたまま、プロバイダー固有のモデル選択を設定に保持します。

FLATKEY_API_KEY="sk-your-flatkey-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_DEEPSEEK_MODEL="deepseek-flash"

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-flash"),
    messages=[
        {
            "role": "user",
            "content": "DeepSeek ルートが生きていることを確認する1文を返してください。",
        }
    ],
    stream=False,
)

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

リクエスト後、Flatkey Usage Logs を開き、モデル名、トークン数、レイテンシ、コスト、キー、タイムスタンプ、エラー状態を確認します。ログが送信したリクエストと一致しない場合、移行は完了していません。

切り替え前のテストマトリクス

よくある間違い

• DeepSeek V4 移行を、現在の DeepSeek ドキュメントを確認せずに単純な文字列置換として扱うこと。
• deepseek-v4-flash-vision-exp を deepseek-flash に置き換えたのに、画像入力を一度もテストしないこと。
• 現在のドキュメントではサービス継続とされているのに、deepseek-v4-pro が 2026 年 9 月 14 日以降に停止したと思い込むこと。
• アプリコードを更新したのに、eval ジョブ、ノートブック、顧客向けスニペット、またはフォールバックポリシーに古いエイリアスが残ったままにすること。
• 承認されたレスポンスあたりのコストではなく、見出しのトークン価格だけを比較すること。
• ライブのルートとログを確認せずに、直接の DeepSeek 挙動と Flatkey 経由の挙動が同一だと決めつけること。
• 未サポートの Responses API パラメータによって、製品の挙動が黙って変わるのを許すこと。

次のステップのための内部リンク

DeepSeek のルートをまだ選定している場合は、このチェックリストを DeepSeek V4 Pro vs Flash および DeepSeek vs Qwen API routing checks と組み合わせてご覧ください。より大きなプロジェクトがゲートウェイの標準化であれば、Flatkey API quickstart、AI model catalog guide、および AI routing API metrics をお読みください。リージョンに配慮したプロバイダー選定については、regional LLM provider routing をご利用ください。

FAQ

現在の DeepSeek Flash モデル名は何ですか？

DeepSeek のドキュメントにおける現在の Flash モデル名は deepseek-flash です。安全な DeepSeek V4 migration では、ルートをテストした後に非推奨の Flash エイリアスをそのモデル文字列へ移行する必要があります。

deepseek-v4-flash と deepseek-v4-flash-vision-exp は壊れていますか？

DeepSeek は、これらの旧名称は引き続き受け付けられるとしていますが、対応するモデルはすでに終了しており、リクエストは DeepSeek-V4.1-Flash によって処理されています。その互換性は移行中には有用ですが、新しいコードでは終了済みのエイリアスに依存しないようにしてください。

deepseek-v4-pro は 2026 年 9 月 14 日以降に動作しなくなりましたか？

いいえ。現在の DeepSeek ドキュメントでは、deepseek-v4-pro の API サービスは 2026 年 9 月 14 日以降も継続し、DeepSeek から追加の通知がない限り課金方式も変更されないとされています。使用する場合は明示的に管理し、監視してください。

DeepSeek のベース URL を変更する必要がありますか？

OpenAI 形式の DeepSeek 呼び出しであれば不要です。DeepSeek は OpenAI 形式のベース URL として https://api.deepseek.com を案内しています。Flatkey を使う場合は、Flatkey API key とともに https://router.flatkey.ai/v1 を使用してください。

Flatkey はプロバイダー固有のルートテストに代わりますか？

いいえ。Flatkey はキー、ベース URL、カタログ、利用状況の確認を一元化できますが、チームは依然として、正確なモデル行、機能の挙動、コスト項目、ルートの健全性、フォールバック計画を検証する必要があります。

すべてのワークロードを deepseek-flash に移行すべきですか？

いいえ。deepseek-flash は現在の Flash の移行先ですが、意図的に deepseek-v4-pro を使うワークロードは、個別にテストして追跡すべきです。全体一律の置換ルールではなく、ワークロードごとに選択してください。

最終的な展開アドバイス

DeepSeek V4 Migration Checklist: Replace Deprecated Aliases Safely は、マージ済みの差分だけでなく、証拠をもって終えるべきです。終了済みの Flash エイリアスを置き換え、Pro ルートは意図的に維持し、製品が実際に使用する機能をテストし、ログでリクエストを検証してください。そのうえで、本番トラフィックを移す前に、現在の Flatkey model directory と Flatkey pricing ページを確認してください。