DeepSeek-V4-FlashがレスポンスAPIとCodexに対応：開発者必見

DeepSeekの7月31日のV4-Flashリリース発表に隠されていた最も戦略的に興味深い一文は、公式V4-Flashが「Responses APIフォーマットをネイティブにサポートし、Codexに完全に適合している」というものだ。

もう一度読んでほしい。中国のオープンウェイトラボが、OpenAIが自社のエージェント製品のために構築した最新のAPIフォーマットを実装したのだ。これは、OpenAI自身のコーディングエージェントがDeepSeekモデル上で動作できるようにするためである。変更ログには、その動機が明確に述べられている。「Codexの需要に応えるため、当社のAPIはResponses APIフォーマットをサポートするようになりました。」

本記事では、それが実際に何を意味するのかを解説する。実装の互換性、黙って無視されるもの、2分でV4-FlashをCodexに接続する方法、そして注意すべき点だ。基本的なAPIセットアップから始める必要がある場合は、まずV4-Flash公開ベータ版ガイドを参照してほしい。

ボタン

ここでResponses APIが重要な理由

OpenAIは、Chat Completionsの後継としてResponses APIを導入した。これは、エージェントワークロード向けに設計された単一のインターフェースで、ファーストクラスの推論アイテム、組み込みツール、セマンティックストリーミングイベントを備えている。OpenAI Responses APIの使い方でこのフォーマットを詳しく解説しているが、要するに、Codexを含むOpenAIのエージェントスタックがネイティブに話すフォーマットなのだ。

これまで、Responses APIクライアントの背後でOpenAI以外のモデルを実行するには、翻訳プロキシが必要か、または何もできなかった。DeepSeekはプロキシを飛ばし、https://api.deepseek.comでサーバーサイドにフォーマットを実装した。既存のOpenAI SDKは変更なしで動作する。

# pip3 install openai
from openai import OpenAI

client = OpenAI(
    api_key="<your DeepSeek API key>",
    base_url="https://api.deepseek.com"
)

response = client.responses.create(
    model="deepseek-v4-flash",
    instructions="You are a helpful assistant.",
    input="Hi, how are you?",
)

print(response.output_text)

興奮する前に一点注意がある。Responses APIは現在、deepseek-v4-flashのみで動作する。DeepSeekによると、deepseek-v4-proのサポートは2026年8月上旬に提供される予定だ。

互換性はどの程度か？

DeepSeekは完全な互換性マトリックスを公開しており、これは多くの「OpenAI互換」プロバイダーが手間をかけて行わないことだ。重要な項目は以下の通り。

サポートされ、動作するもの：

input と instructions（文字列またはアイテムリスト形式）
stream（完全なセマンティックイベントシーケンス）
temperature, top_p, max_output_tokens, top_logprobs
function および web_search タイプを持つ tools（ウェブ検索はサーバーサイドで実行される）
特定の関数を強制することを含む tool_choice
思考の深さのための reasoning.effort

受け入れられるが機能しないもの：

reasoning.summary は受け入れられるが、要約は生成されない
text.verbosity は受け入れられるが、効果はない
parallel_tool_calls は常に並列ツール呼び出しがオンであるため無視される

設計上サポートされていないもの：

previous_response_id および conversation: APIはステートレスであるため、会話履歴は自分で管理し、入力アイテムリストとして送信する必要がある
store: すべての応答は store: false で返される
background, metadata, include, service_tier、およびプロンプトキャッシュキー: 代わりにコンテキストキャッシュが自動的に行われる

優れた点としては、サポートされていないパラメータは拒否されるのではなく黙って無視されるため、既存のResponses APIクライアントは変更なしで接続できる。厳しい点としては、100万トークンのコンテキストウィンドウを超えるリクエストは、切り捨てられる代わりに400エラーを返す。

ストリーミングはResponses APIのイベントモデルに従い、response.created から response.completed までが続き、推論デルタ（response.reasoning_text.delta）は出力テキストとは別のイベントとして到着する。data: [DONE]のような終端記号はなく、ストリームは response.completed、response.incomplete、または response.failed イベントで終了する。もしSSEハンドラーが [DONE] を待つように設定されている場合、ハングアップするだろう。サーバー送信イベントによるAPIレスポンスのストリーミングに関するガイドでは、このような方言の違いに対応するための防御的な解析パターンについて解説している。

DeepSeek-V4-FlashでCodexをセットアップする

CodexはResponses APIを通じてモデルと通信するが、これこそがこのリリースが存在する理由である。DeepSeekの統合ガイドは2つのパスを提供しており、それらは1つの設定を共有するため、すべてのCodexクライアント（CLI、ChatGPTデスクトップアプリ、VS Code拡張機能）を一度に構成する。

ワンクリックスクリプト

Codex CLIまたはChatGPTデスクトップアプリがインストールされており、少なくとも一度は実行されていることを確認してから、以下を実行してください。

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh)

WindowsユーザーはPowerShell版を実行します。

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

このスクリプトは初回実行時にDeepSeek APIキーを求め、その後4つのことを行う。既存の~/.codex/config.tomlを~/.codex/backup-deepseek/にバックアップし、モデルカタログを~/.codex/models.jsonに書き込み、MCPサーバーとプロジェクトの信頼設定を保持しつつ設定に[model_providers.deepseek]セクションを追加し、書き込む前に構文を検証する。モデルを切り替えたり、メニューから元の設定を復元したりするために、いつでも再度実行できる。

curlをbashにパイプする際には一般的な注意が適用される。もしそれがあなたのポリシーであれば、まずスクリプトを読んでほしい。バックアップと検証の挙動は良い兆候だが、それでもあなたのCodex設定に触れるサードパーティのスクリプトである。

モデルカタログが示すもの

スクリプトが書き込むmodels.jsonは、DeepSeekがCodex内でモデルをどのように位置づけているかを文書化しているため、読む価値がある。

コンテキストウィンドウ: 1,048,576トークン
推論レベル: low, high, max（デフォルトはhigh）
並列ツール呼び出しをサポート
Codexクライアントバージョン0.144.0以降が必要

カタログはV4-Flashを「最新のフロンティアエージェントコーディングモデル」と表現しており、現在はdeepseek-v4-flashのみが動作する。カタログには、8月上旬にサポートが開始されるdeepseek-v4-proもすでに含まれている。

Codex内で実際に通用するのか？

DeepSeekの主張は、0731の再ポストトレーニングがまさにこのワークロードを対象としていたというものだ。彼らが発表したエージェントの数値は、Terminal Bench 2.1で82.7、Cybergymで76.7、Toolathlonで70.3、DeepSWEで54.4で、いずれもV4-Pro-Previewを上回ったと報告されている。これらは、独立した実行結果が出るまではベンダーの数値として扱うべきだ。これらはDeepSeek独自のハーネスを最大限に活用して生成されたものであり、発表におけるベンチマークの2つは内部テストセットである。

経済性は反論しがたい。入力トークン100万件あたり0.14ドル（キャッシュミスの場合）、出力トークン100万件あたり0.28ドルで、V4-FlashはCodexが通常実行するモデルのほんの一部しか費用がかからず、キャッシュヒットの場合は入力コストが0.0028ドルに下がる。一日中エージェントセッションを多用しても、その間に飲むコーヒー代よりも安い。完全なコスト表については、ベータガイドの料金セクションを参照してほしい。Codex自体を代替案と比較検討しているのであれば、Claude Code vs Codex CLI比較がそのエージェント側面をカバーしている。

エージェントを信頼する前にエンドポイントを検証する

エージェントのデバッグ可能性は、その背後にあるAPIに依存する。そして、真新しい公開ベータ版エンドポイントは、Codexを実際のレポジトリに解き放つ前にテストする価値がある。これはApidogで5分でできる作業だ。

POST https://api.deepseek.com/responses をエンドポイントとして追加し、キーを環境変数に保存します。
最小限の responses.create ペイロードを送信し、出力アイテムの形式（reasoning アイテムの後に message アイテムが続く）を確認します。
stream: true をオンにして、イベントシーケンスをリアルタイムで監視します。ApidogはSSEイベントが到着するたびに表示するため、クライアントが response.output_text.delta をリッスンすべきか、あるいは決して来ない何かを待つべきかが明らかになります。
function ツールがアタッチされたリクエストを保存し、function_call の出力形式がハンドラーの期待するものと一致するか確認します。

V4-Pro Responsesの展開が8月に開始されたら、同じ保存済みリクエストを新しいモデル名に対して再実行し、動作の違いを確認してください。Apidogを無料でダウンロードして、すべてのスイートを1つのプロジェクトにまとめてください。

よくある質問

Responses APIで動作するDeepSeekモデルはどれですか？ 現在はdeepseek-v4-flashのみです。deepseek-v4-proのサポートは2026年8月上旬に予定されています。

新しいSDKは必要ですか？ いいえ。公式のOpenAI SDKが動作します。base_urlをhttps://api.deepseek.comに向け、client.responses.createを呼び出してください。セットアップの詳細は、当社のV4-Flash公開ベータガイドに記載されています。

複数ターンの状態はOpenAIのバージョンと同じように動作しますか？ いいえ。DeepSeekの実装はステートレスです。previous_response_id、conversation、storeはサポートされていません。毎回呼び出し時に完全な履歴を入力アイテムとして送信してください。

CodexでOpenAIアカウントと並行してDeepSeekを使用できますか？ はい。セットアップによりDeepSeekがモデルプロバイダーとして追加されます。スクリプトのメニューでモデルを切り替えられ、元の設定はバックアップされているため復元可能です。

これはAnthropic APIの互換性と同じですか？ 別の機能です。DeepSeekは、Claude Code統合が動作するhttps://api.deepseek.com/anthropicでAnthropic形式のエンドポイントも公開しています。Responses APIエンドポイントは、CodexのようなOpenAI形式のエージェントツール向けに存在します。

このリリースが本当に示唆するもの

モデルの品質は収束しつつあり、競争は統合レイヤーへと移行している。DeepSeekは、開発者が実際にどこで作業しているか、つまりCodexのようなエージェント内部に注目し、そこにドロップイン可能なバックエンドとなるために必要な配管を正確に構築した。それは、どのパラメータが黙って無視されるかまで公開するほどだ。このような透明性は稀であり、互換性の話に信頼性をもたらしている。

この戦略は明白かつ賢明だ。OpenAIがエージェントを提供し、DeepSeekがその10分の1の価格でトークンを提供する。0731モデルがV4-Pro-Previewをあなたのコードベースで本当に上回るかどうかは、あなた自身の評価でしか答えられない。それをApidogに接続し、両方に対してテストスイートを実行し、ベンチマークの表ではなく、結果に判断を委ねてほしい。