DeepSeek API ドキュメントのウォークスルーとそのまま置き換え可能な代替エンドポイント
deepseek api docs を開くほとんどの人は、Base URL、認証方法、使用するモデル名、有効なパラメータ、動作する呼び出し例という 5 つの答えを知りたいのです。このページではそれらを解説し、その後、置き換え可能な別の OpenAI 互換エンドポイントでの同じ呼び出しを示します。


主要ポイント
- DeepSeek は OpenAI 風 API を文書化しているため、Base URL、キー、モデル名を変更するだけで OpenAI SDK が動作します。
- このサイトは DeepSeek の公式 API ではなく、ID uncensored の独立したオープンウェイトモデルを一つ提供しています。
- 同じコードが両方で動作します:変更されるのは 3 つの値だけです。
- ここでのコンテキストウィンドウは 100,000 トークンで、ストリーミング、ツール、JSON モードがサポートされています。
DeepSeek API ドキュメントが答える 5 つのこと
開発者が deepseek api docs を検索する際は、通常、最初のリクエストを完了させようとしています。そのパターンは OpenAI 風サービスと同じであるため、表で比較すると容易です。
| 質問 | DeepSeek のドキュメント | このAPI |
|---|---|---|
| ベース URL | クイックスタート(api.deepseek.com)で文書化されています | https://api.deepseek4api.com/v1 |
| 認証 | Authorization ヘッダーの Bearer トークン | Authorization ヘッダーの Bearer トークン |
| モデル名 | モデルのドキュメントに記載されています。現在の名前を確認してください | uncensored |
| メインのエンドポイント | チャット補完 | チャット補完、レスポンス、モデル一覧 |
| 料金 | 現在の料金を確認 | 入力トークン 1M あたり $0.15、出力トークン 1M あたり $0.50 |
モデル、価格、制限に関する情報は、DeepSeek公式ページをお読みください。それらは変更されるため、本記事ではそれらを再述するものではありません。重要なのは、リクエストの形状が共通であるため、両者の間を移動するのは設定変更のみで済む点です。
明確にしておくべき点があります:このサイトは DeepSeek の公式 API ではありませんし、DeepSeek へのルーターでもありません。これは独立したプロバイダが運用し、合法的な成人向け利用においてコンテンツ拒否なしで回答するよう調整された、ホストされた OpenAI 互換エンドポイントであり、1 つのオープンウェイトモデルを提供しています。
ステップ 1:認証と Base URL
アカウントを作成(Google、またはメールとパスワード)し、APIキーページを開きます。キーをコピーしてください。新規ユーザーは、ワンクリックで7日間有効でカード不要の$0.50の無料トライアルクレジットを受け取ることができます。
すべてのリクエストにはヘッダー Authorization: Bearer YOUR_KEY が付きます。curl の場合:
curl https://api.deepseek4api.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
これは利用可能なモデル、uncensoredを一覧にします。DeepSeekの例をコピーする場合は、3つの項目を変更してください:ベースURL、キー、モデル名。それ以外の変更は不要です。
ステップ2:Pythonでのチャット完了
OpenAI SDK は DeepSeek のドキュメントが例で使用するものであり、ここでは変更なしで動作します:
from openai import OpenAI
client = OpenAI(
base_url="https://api.deepseek4api.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise technical assistant."},
{"role": "user", "content": "Explain idempotency in two sentences."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)
temperature、top_p、stop、seedおよび存在ペナルティと頻度ペナルティを含む、サポートされているサンプリングパラメータはそのまま渡されます。max_tokensはオプションです。補完は100,000トークンのウィンドウの残りを何でも使用できるためです。
ステップ3:ストリーミング、JSONモード、ツール
ストリーミング
サーバー送信イベントを受信するには stream: true を設定します。使用量はストリームの末尾で報告されます。
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.deepseek4api.com/v1",
apiKey: process.env.API_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a haiku about caching." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
JSON モード
response_format: {"type": "json_object"} を渡し、プロンプトで JSON に言及してください。出力は直接解析できる JSON オブジェクトです。
関数呼び出し
toolsおよびtool_choiceパラメータはOpenAIフォーマットで機能し、ツール呼び出しはデルタとしてストリーミングされ、role: "tool"メッセージとして結果を返します。すでにDeepSeekに対して関数呼び出しを行うコードがある場合、上記の3値の変更で移植可能ですが、独自のスキーマをテストしてください。
2つの相違点
同じプロトコルが同じサービスを意味するわけではありません。ワークロードを移動する際に確認すべき事項:
- モデルの動作。 異なるモデルは異なる回答、推論スタイル、拒否動作を提供します。本番環境で何かを変更する前に、プロンプトセットを再実行してください。
- 推論固有のフィールド。特定のDeepSeekモデルからのベンダー固有のレスポンスフィールドに依存している場合、それらがここにあると想定しないでください。標準的なチャット補完フィールドはあります。
- 提供されない機能。 この API はテキストのみです:画像、オーディオ、ビデオ、埋め込み、ファインチューニングはありません。
- 制限事項 通常キーは同時8リクエスト、1分間300リクエストまで許可されます。試用キーは同時2リクエスト、1分間60リクエストまでです。制限超過時はHTTP 429エラーで、
rate_limitedまたはconcurrencyが返されます。 - 残高。
GET /v1/balance、OpenAI 風のクレジット付与ルーティング、または各レスポンスのX-Balance-USDヘッダーでクレジットを確認してください。
DeepSeek重視のユーザーがコストをどう考えるかについては、DeepSeek価格メモを参照してください。エディタセットアップについては、VS Codeガイドをご覧ください。
ここでの呼び出しコスト
課金は前払いでトークン単位です:入力トークン 1M あたり $0.15、出力トークン 1M あたり $0.50。入力トークン 1,500 と出力トークン 600 のリクエストのコストは、入力で 1,500 x $0.15 / 1M = $0.000225、出力で 600 x $0.50 / 1M = $0.0003、合計 $0.000525 です。$20 のチャージで、このような呼び出し約 38,000 回をカバーできます。
チャージは $20 から $500 の任意の整数額を受け付け、$50 以上で +5%、$100 以上で +10%、$200 以上で +15% のボーナスが付きます。暗号資産(TRC20 上の USDT、Base 上の USDC)で支払えます。クレジットは期限切れにならず、失敗または拒否されたリクエストには課金されません。詳細は 価格ページ を参照してください。
マイグレーションチェックリスト
すでに DeepSeek と通信しているアプリをポートする場合、これらを順番に実行してください。各ステップは数分で完了します。
- 3 つの値を構成に設定する。 Base URL、キー、モデル名はコード中に散らばった定数ではなく、環境変数から取得すべきです。
- スモークテストを実行します。チャット補完1回、ストリーミング補完1回、JSONモード呼び出し1回、ツール呼び出し1回。上記の4つのスニペットがそれらをカバーしています。
- 実際のプロンプトを再生する。 ログから 30 個のプロンプトを取得し、回答を並べて比較してください。一般的なスコアではなく、あなた自身の基準で評価してください。
- 429 を処理する。 バックオフ付きのリトライを追加し、
Retry-Afterを尊重してください。ストリーミングされたリクエストはストリームが終了するまで同時実行スロットを保持するため、放棄されたストリームは閉じてください。 - コストを監視する。 各レスポンスの
usageをログに記録し、1 日のトラフィック中にX-Balance-USDヘッダーと比較してください。 - 段階的にリリースする。 まずトラフィックの 5〜10% を新しいエンドポイントに送り、その後増やしてください。
トークンあたりの価格ではなく、タスクあたりのコストを比較してください。異なるモデルは、同じタスクに異なる数のトークンを使用するためです。許容的な書き込みモデルの動作をオープンエンドに確認するには、ロールプレイ解説が有用な補完資料となります。
どちらを選ぶか
DeepSeek モデル、ベンダー固有の機能、または公式サポートを特に必要とする場合は、DeepSeek 自身の API を使用してください。合法的な成人向け利用においてコンテンツ拒否なしで回答する、ホストされた OpenAI 互換モデル、シンプルな前払い課金、トレーニングに使用されないプロンプトを望む場合は、このエンドポイントを使用してください。多くのチームは、共有プロトコルが容易にする構成スイッチの背後に両方を配置したがるでしょう。この API のリファレンス資料は ドキュメント にあります。
その他のガイド
質問と回答
これは公式のDeepSeek APIですか?
いいえ。これは独立した OpenAI 互換のエンドポイントであり、ID uncensored のオープンウェイトモデルを一つ提供しています。DeepSeek のサービスではなく、DeepSeek へルーティングもされません。
DeepSeek のコードを再利用できますか?
OpenAI SDK または chat completions フォーマットを使用している場合、通常は可能です。Base URL、キー、モデル名を変更し、プロンプトでテストしてください。
モデル名はどこで確認できますか?
GET /v1/models を呼び出してください。この API は ID が uncensored の単一モデルを提供します。
コンテキストウィンドウの長さは?
プロンプトと補完を合わせて 100,000 トークン。