すでに OpenAI 形式の SDK を使用している製品内で DeepSeek API access が必要な場合、最もきれいな移行パスは通常、クライアントを全面的に書き換えることではありません。ベース URL、API キー、モデル ID の決定です。
DeepSeek の公式 API ドキュメントによると、API は OpenAI および Anthropic と互換性のある形式を使用します。2026 年 6 月 11 日時点で、公式クイックスタートにおける現在の DeepSeek モデル名は deepseek-v4-flash と deepseek-v4-pro です。旧エイリアスの deepseek-chat と deepseek-reasoner も引き続き記載されていますが、DeepSeek は両方とも 2026 年 7 月 24 日 15:59 UTC に廃止予定として示しています。
このモデル名の詳細は重要です。DeepSeek API access に関するガイドの多くはいまだに古いエイリアスを示していたり、プロバイダー直結のキーだけに焦点を当てたりしています。このガイドでは、直接の DeepSeek アクセスをどう評価するか、また Flatkey のような OpenAI 互換ルーター経由で DeepSeek を追加する方法を示します。同じアプリケーションパターンを、GPT、Claude、Gemini、Qwen、Seedance、そして画像モデルと並べて使うことができます。
Quick Answer: 直接 DeepSeek API アクセス vs Router アクセス
最適なDeepSeek API アクセスの方法は、何を自分で管理したいかによって決まります。
| Access Path | Use It When | What Changes In Code | What To Check |
|---|---|---|---|
| Direct DeepSeek API | DeepSeek のアカウントを直接持ち、DeepSeek の価格体系を直接使い、DeepSeek のネイティブなドキュメントを信頼できる情報源として使いたい場合。 | OpenAI SDK の base URL を https://api.deepseek.com に設定し、DeepSeek API key を使用します。 |
DeepSeek ドキュメント内の現在のモデル名、非推奨 नोट、価格、トークン制限、レート制限。 |
| Flatkey OpenAI-compatible router | 1つの API key で DeepSeek を他のモデルファミリーと一緒に使いたい場合、統合請求、キー・利用状況・ルーティング用のダッシュボードが欲しい場合。 | base URL を https://router.flatkey.ai/v1 に設定し、Flatkey の key を使用して、Flatkey に掲載されている DeepSeek の model ID を選びます。 |
Flatkey の model catalog の提供状況、model ID の表記、価格ページ、最初の呼び出し後の利用ログ。 |
| Self-hosted proxy | 自社のゲートウェイ、ポリシーレイヤー、またはプライベートなルーティング基盤を運用する必要がある場合。 | アプリはプロキシのエンドポイントを指し、プラットフォームチームがそのプロキシを各プロバイダーのアカウントに接続します。 | デプロイ、シークレット、可観測性、インシデント対応、プロバイダーアカウントの所有権。 |
チームが必要としている DeepSeek のワークロードが1つだけで、直接の商取引関係を望むなら、プロバイダー直結のセットアップはシンプルです。チームが既存のマルチモデルスタックに DeepSeek を追加するなら、ルーター आधारितのDeepSeek API アクセスは、アカウントの乱立を減らし、すでに使っている OpenAI 互換クライアントのパターンに近い形で移行できます。
最初に確認すべき現在の DeepSeek の事実
DeepSeek API access を出荷する前に、公開またはデプロイする当日にモデル名を確認してください。DeepSeek の公式ドキュメントでは、現在この基本情報が示されています。
| 項目 | 現在の公式詳細 |
|---|---|
| OpenAI 形式のベース URL | https://api.deepseek.com |
| Anthropic 形式のベース URL | https://api.deepseek.com/anthropic |
| 現在のモデル ID | deepseek-v4-flash と deepseek-v4-pro |
| 非推奨エイリアス | deepseek-chat と deepseek-reasoner は、2026 年 7 月 24 日 15:59 UTC 以降は非推奨として記載されています。 |
| コンテキストと出力 | DeepSeek の価格ページでは、現在の V4 モデルについて、コンテキスト長 1M と最大出力 384K が記載されています。 |
| 料金の基準 | DeepSeek の価格ページでは、料金は 1M トークンあたりで記載されており、最新の価格はページで確認するよう推奨しています。 |
だからこそ、現代的な DeepSeek API access ガイドでは、デフォルトモデルとして deepseek-chat をハードコードすべきではありません。今日そのエイリアスを使っているなら、deepseek-v4-flash または deepseek-v4-pro への移行計画を作成してください。ルーターを使っている場合は、そのルーターのカタログが現在の DeepSeek モデル ID、旧互換エイリアス、またはその両方を公開しているか確認してください。
OpenAI SDK を使った DeepSeek API への直接アクセス
DeepSeek API への直接アクセスでは、アプリがすでに OpenAI SDK を使っていれば、セットアップは見覚えのあるものに感じられるはずです。クライアントを作成し、ベース URL を変更し、DeepSeek API キーを使用して、DeepSeek モデルを呼び出します。
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DEEPSEEK_API_KEY,
baseURL: "https://api.deepseek.com"
});
const response = await client.chat.completions.create({
model: "deepseek-v4-pro",
messages: [
{ role: "system", content: "You are a concise technical assistant." },
{ role: "user", content: "Summarize this migration plan." }
],
stream: false
});
console.log(response.choices[0].message.content);DeepSeek アカウント自体が要件に含まれる場合は、この経路を使用してください。DeepSeek API への直接アクセスでは、DeepSeek のドキュメント、料金、レート制限、サポート経路が主な運用モデルとして維持されます。
直接セットアップでは、DeepSeek 固有のパラメータに関する曖昧さも最小限に抑えられます。DeepSeek の現在の例には、V4 モデル向けの thinking 関連フィールドが含まれています。これらのパラメータがワークロードにとって重要であれば、まず DeepSeek に直接対してテストし、その後、ゲートウェイ経由で本番利用する前に、ルーターが同じフィールドをそのまま通過させるか確認してください。
Flatkey 経由の DeepSeek API アクセス
Flatkey は、より広いスタックの中で DeepSeek API アクセス が 1 つのモデルファミリー要件である場合に便利です。Flatkey の公開製品説明では、開発者は 1 つの API キーで Claude、GPT、Gemini、DeepSeek、Qwen、Seedance 2.0、GPT Image などにアクセスでき、個別のプロバイダーアカウントを管理する必要がないとされています。また、明確な料金体系、統合請求、キー・使用量・ルーティング用の 1 つのダッシュボード、さらに自動切り替えと負荷分散についても説明されています。
ルーター移行パターンは意図的に小さくなっています:
- Flatkey の API キーを作成するか、既存のものを使用します。
- OpenAI 互換クライアントの接続先を
https://router.flatkey.ai/v1に設定します。 - Flatkey の料金ページまたはダッシュボードに表示される DeepSeek モデル ID を選択します。
- 重要度の低いリクエストを 1 回実行します。
- ダッシュボードでレスポンス、モデルルート、使用記録、コスト行を確認します。
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: "https://router.flatkey.ai/v1"
});
const response = await client.chat.completions.create({
model: "deepseek-v4-pro", // デプロイ前に現在の Flatkey モデル ID を確認してください。
messages: [
{ role: "system", content: "You are a concise technical assistant." },
{ role: "user", content: "Draft a release note for this feature." }
]
});
console.log(response.choices[0].message.content);2026 年 6 月 11 日時点で、Flatkey の公開料金エンドポイントは 653 のモデル行を返し、deepseek-v4-flash、deepseek-v4-pro、deepseek-v3.2、deepseek-v3.2-thinking、deepseek-chat、deepseek-reasoner などの DeepSeek 行が含まれていました。これは恒久的な保証ではなく、日付付きのカタログスナップショットとして扱ってください。本番での DeepSeek API アクセス では、モデル ID を選択する前に、最新の Flatkey 料金ページとアカウントのモデルピッカーを確認してください。
ルーターが直接キーよりも役立つ場合
ルーターが、直接のDeepSeek API アクセスよりも自動的に優れているわけではありません。周辺のアクセス層が難しい場合にこそ有効です。
DeepSeek API アクセスをルーター経由にするのが適しているのは、次のような場合です。
- アプリがすでに OpenAI 互換のチャット完了 API を呼び出している。
- 各開発者ごとに別のプロバイダーアカウントの運用を増やさずに DeepSeek を追加したい。
- 同じ製品機能で DeepSeek を GPT、Claude、Gemini、Qwen と比較したい。
- チーム向けに請求と利用状況を一元的に確認したい。
- トラフィックが増える前にクォータ運用の習慣を整えたい。
- モデル名、プロバイダーのルール、価格が変わったときに、よりスムーズに移行したい。
直接のDeepSeek API アクセスがより適しているのは、次のような場合です。
- DeepSeek との直接契約、またはプロバイダーとの関係が必要。
- ルーターがまだそのまま通せない可能性のある、DeepSeek 固有のリクエストパラメータをテストしている。
- 調達やデータポリシー上、プロバイダーとの直接契約条件が必要。
- マルチモデルのルーティング要件なしで、DeepSeek 専用のワークロードを 1 つに切り分けたい。
既存の OpenAI 互換アプリ向け移行チェックリスト
DeepSeek API access を本番パスへ移す前に、このチェックリストを使用してください。
| 手順 | 実施内容 | 重要な理由 |
|---|---|---|
| 1 | 正確なワークロードを列挙します: chat、reasoning、JSON output、tool calls、または code assistance。 | DeepSeek V4 のモデル選択と thinking mode は、ワークロードに一致している必要があります。 |
| 2 | 現在のモデル ID を選択します。利用可能な場合は deepseek-v4-flash または deepseek-v4-pro を推奨します。 |
旧いエイリアスには、公式 DeepSeek docs に記載された古い deprecation notice があります。 |
| 3 | 本番以外の環境で base URL と API key を変更します。 | これにより、移行が実際には rewrite ではなく config change であることを確認できます。 |
| 4 | 小さなテスト prompt を送信し、response shape、token usage、errors を確認します。 | OpenAI-compatible であっても、モデルの挙動を検証する必要はなくなりません。 |
| 5 | アクセス経路に応じて、DeepSeek または Flatkey で billing と usage logs を確認します。 | コストの可視性はアクセス判断の一部であり、後回しにするものではありません。 |
| 6 | 1つの upstream error、timeout、または quota condition に対する fallback behavior をテストします。 | Router users は、モデル route が失敗したときに何が起こるかを把握する必要があります。 |
| 7 | config 内で model IDs を固定し、2026年7月24日までに model-name review を予定します。 | これにより、DeepSeek が公表した日付以降に deprecated aliases に依存することを避けられます。 |
無料の DeepSeek API アクセスについて
このトピックに関する一部の検索では、DeepSeek API key free access、DeepSeek R1 free API access、または DeepSeek API free access limits などの用語が使われます。現在のプロバイダーまたはルーターページでその提供内容が明示的に文書化されていない限り、これらの表現を前提に本番向けの計画を立てないでください。
DeepSeek の公式価格ページは、プロバイダー直結の料金を確認するための正しい情報源です。Flatkey の価格ページは、Flatkey 経由の利用料金を確認するための正しい情報源です。無料の DeepSeek API アクセス上限は、無料枠がすぐに変更される可能性があり、登録当日に必ずその情報源で確認する必要があるため、この記事では主張していません。
推奨セットアップ
既存の OpenAI 互換アプリに DeepSeek を追加するほとんどのプロダクトチームは、まず小規模なルーターテストから始めてください:
- Flatkey の 料金ページを開き、現在の DeepSeek モデル ID を確認します。
- Flatkey のキーを作成し、
baseURLをhttps://router.flatkey.ai/v1に設定します。 - モデルがアカウントで利用可能として一覧表示されている場合に限り、
deepseek-v4-flashまたはdeepseek-v4-proで 1 件の低リスクなリクエストを実行します。 - 利用状況と請求記録を確認します。
- プロダクトでマルチモデルルーティングが必要な場合は、同じワークロードを GPT、Claude、Gemini、または Qwen と比較します。
この方法なら、DeepSeek API アクセスを実用的に保てます。DeepSeek の公式モデル名と非推奨に関する注意事項は引き続き尊重しつつ、チームが他のモデルスタックにも使えるのと同じルーター、請求、利用状況のワークフロー内で DeepSeek を評価できます。
本番トラフィックを移行する前に、料金を確認して Flatkey の現在の DeepSeek モデルカタログをチェックし、ルーティングされた利用状況を比較してください。
FAQ
現在の DeepSeek API ベース URL は何ですか？
OpenAI 形式の DeepSeek API access を直接使う場合、DeepSeek の公式ドキュメントには https://api.deepseek.com が記載されています。Anthropic 形式のアクセスについては、ドキュメントに https://api.deepseek.com/anthropic とあります。Flatkey 経由では、OpenAI 互換ルーターのベース URL は https://router.flatkey.ai/v1 です。
今はどの DeepSeek モデルを使うべきですか？
DeepSeek の現在の公式クイックスタートには deepseek-v4-flash と deepseek-v4-pro が記載されています。ドキュメントによると、deepseek-chat と deepseek-reasoner は 2026 年 7 月 24 日 15:59 UTC に非推奨となるため、新しい DeepSeek API access の実装では、これらのエイリアスを長期的なデフォルトとして扱わないようにしてください。
DeepSeek に OpenAI SDK を使えますか？
はい。DeepSeek のドキュメントでは、API 形式は OpenAI と Anthropic に互換性があると説明されています。OpenAI SDK を使う場合、DeepSeek への直接アクセスでは DeepSeek のベース URL とキーを使用します。Flatkey を使う場合、ルーター経由の DeepSeek API access では Flatkey のベース URL とキーを使用します。
Flatkey は無料の DeepSeek API access を提供していますか？
このガイドでは、無料の DeepSeek API access については明言していません。ルーティング利用に関する最新の Flatkey pricing page と、直接プロバイダーの料金については DeepSeek の公式料金ページをご確認ください。
なぜ直接の DeepSeek キーではなく Flatkey を使うのですか？
DeepSeek が複数モデル構成の一部で、1 つの API キー、統一請求、利用状況の可視化、OpenAI 互換ルーターが必要な場合は Flatkey を使います。直接の DeepSeek API access は、直接のプロバイダーアカウント、DeepSeek への直接サポート経路、またはプロバイダー固有のリクエスト挙動が必要な場合に使います。
