DeepSeek API URLとBase URL:切り替え方法
DeepSeekの公式ドキュメントからコピーするdeepseek api urlはBase URLであり、DeepSeekのキーとDeepSeekのモデルでのみ機能します。異なるOpenAI互換エンドポイントを使用したい場合は、そのURL、キー、モデルIDを変更します。
更新日:
主要ポイント
- Base URLはプレフィックスであり、SDKはこれに/chat/completionsを追加します。
- このサービスはhttps://api.getdeepseekapi.com/v1を使用し、モデルIDはuncensoredです。
- これは DeepSeek の API ではないため、DeepSeek のキーはここで機能せず、その逆も同様です。
- ほとんどのクライアントは、OPENAI_BASE_URLとOPENAI_API_KEYを通じてURLとキーも受け入れます。

Base URL、エンドポイント、パス:3つの部分
人々はプレフィックスを期待するフィールドに完全なアドレスを貼り付け、404エラーに陥ることがよくあります。この区別を保つための3つの用語があります。
- Base URL: すべての呼び出しの共通プレフィックス(例:
https://api.getdeepseekapi.com/v1)。これはクライアントの「API base」または「Base URL」設定に入力するものです。 - エンドポイントパス:SDKによって追加される部分、例えば
/chat/completions、/responses、または/models。 - 完全なURL: ベースURLにパスを加えたもの(例:
https://api.getdeepseekapi.com/v1/chat/completions)。curlなどの生HTTPクライアントでは、こちらを使用する必要があります。
最も多くの人を混乱させるルール:SDKやアプリはBase URLを求め、curlやHTTPノードは完全なURLを求めます。ツールが404を返す場合は、まずBaseが期待される場所に完全なURLを入れたか、その逆ではないかを確認してください。エラーに/v1/chat/completions/chat/completionsのようなパスの重複が含まれている場合は、それが手がかりです。
DeepSeekのBase URLとは何か、そして何ではないか
DeepSeekは、APIのアドレスとキーで使用可能なモデル名をドキュメントで公開しています。ブログ記事(このページを含む)を信じるのではなく、そちらで現在の値を確認してください。DeepSeekのキーはDeepSeekのエンドポイントでのみ機能し、他の場所では機能しません。
このサイトのサービスは別の製品です。公式のDeepSeek APIではなく、DeepSeekへのフォワードも行わず、DeepSeekのモデルも提供しません。これは独立したプロバイダが運用する、オープンウェイトモデルの1つに特化したホスト型OpenAI互換APIであり、法的に成人による使用向けにコンテンツ拒否なしで応答するよう調整されています。そのアドレスは以下の通りです:
https://api.getdeepseekapi.com/v1 # model: uncensored
モデルIDはuncensoredであり、認証はAuthorization: Bearer <key>です。キーはAPI keyページで発行されます。各サービスでのキーの意味を比較している場合、DeepSeek API keyのページで詳細をご覧ください。
OpenAI SDKでのエンドポイントの切り替え
Base URLとキーを変更すれば、任意のOpenAI SDKが機能します。Pythonでは:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
Node.jsではフィールドはbaseURLと表記されます:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.getdeepseekapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
違いに注意してください:Pythonはbase_urlを使用し、NodeはbaseURLを使用します。これらを混同すると、デフォルトのOpenAIアドレスにフォールバックし、そこでキーが拒否されます。
コードに触れずに切り替える
公式のOpenAI SDKは2つの環境変数を読み取るため、既存のアプリはコード変更なしでエンドポイントを変更できます:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
モデル名はスキップできない部分です。アプリが別のモデルIDをハードコードしている場合、そのモデルを要求して失敗するため、アプリの設定または構成でuncensoredに変更してください。多くのツールは、API base、API key、modelというラベルでこれら3つの値を1つの設定画面で公開しています。
同じ3値の切り替えがフレームワークでも機能します。例えばPythonのLangChainでは、ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored")だけで十分です。OpenAI互換エンドポイントを受け付けるコーディングツールも同様に動作します。コーディングにAPIを使用するのウォークスルーをご覧ください。
生HTTP:正確なパス
curl、スクリプト、ビルドしたHTTPノードの場合、完全なURLを自分で構築します。このサービスでのパスは以下の通りです:
| 目的 | メソッドとURL |
|---|---|
| チャット | POST https://api.getdeepseekapi.com/v1/chat/completions |
| Responses API | POST https://api.getdeepseekapi.com/v1/responses |
| モデル一覧 | GET https://api.getdeepseekapi.com/v1/models |
| 残高 | GET https://api.getdeepseekapi.com/v1/balance |
| OpenAIスタイルの残高 | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
HTTPSのみを使用してください。ストリーミングはサーバー送信イベント(SSE)経由で"stream": trueで動作し、同じURLが両方のモードを提供します。
設定画面のあるアプリへのURL入力
多くのチャットフロントエンド、エディタ、自動化ツールには「カスタムOpenAI互換エンドポイント」オプションがあります。ラベルは異なりますが、フィールドは1対1で対応します:
| アプリのフィールド | 内容 |
|---|---|
| APIベース、Base URL、エンドポイント、サーバーURL | https://api.getdeepseekapi.com/v1 |
| API key、Token、Secret | このサービスからのキー |
| Model、Model name、Model ID | uncensored |
一部のアプリはベースURLではなく完全なチャットURLを必要とします。その場合はhttps://api.getdeepseekapi.com/v1/chat/completionsを使用してください。アプリに「接続テスト」ボタンがある場合、通常はモデルリストを呼び出します。これはGET /v1/modelsです。ボタンが失敗しても手動チャットが動作する場合、アプリのチェックはAPIよりも厳格であるため、無視して構いません。
URL だけの簡単な動作確認
アプリをデバッグする前に、モデル一覧で URL が機能することを確認してください。ボディは不要で、コストもかかりません:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
data 配列を含む JSON が返されるはずです。HTML のエラーページが返された場合は、ホストまたはパスが間違っています。例えばサブドメインが抜けている場合などです。ホストは api. で始まり、www. ではありません。
よくあるミスの修正
- 404 Not Found. ベース URL に
/v1が抜けている、重複している、またはエンドポイントのパスが含まれています。 - 401 または認証エラー。 あなたは別のサービスのキーを使用しました、またはヘッダーに
Bearerが不足しています。キーはプロバイダ間で互換性がありません。 - モデルが見つかりません。 リクエストではまだ旧プロバイダのモデルが指定されています。
uncensoredを設定してください。 - アプリがまだ旧サービスに接続している。 一部のツールは設定をキャッシュしたり、異なる変数を読み込んだりします。プロセスを再起動し、設定画面を確認してください。
- 末尾のスラッシュの問題。 ほとんどのクライアントは処理できますが、処理できない場合はベース URL の末尾のスラッシュを削除してください。
どちら側で失敗しているか分からない場合は、上記の curl コマンドを送信してください。200 応答は URL、キー、モデルが正しいことを証明します。それ以外の障害はアプリ側にあります。ドキュメント には制限事項や X-Request-Id などのヘッダーが記載されており、サポートに連絡する際に役立ちます。
移行後も変わらない点
リクエストとレスポンスの形式は OpenAI フォーマットに従うため、メッセージ配列、temperature、top_p、stop、seed、ペナルティ、ツール呼び出し、JSON モードは通常どおり動作します。コンテキストウィンドウはプロンプトと生成トークンを合わせて 100,000 トークン、最大リクエストボディは 8 MB です。サービスはテキストのみ対応で、画像、オーディオ、埋め込み、ファインチューニングはサポートしないため、それらに依存する機能には別のプロバイダが必要です。
請求も旧プロバイダとは別です:前払いクレジットから、入力トークン 100 万トークンあたり $0.15、出力トークン 100 万トークンあたり $0.50 です。詳細は 料金ページ を参照してください。新規ユーザーは、支払い前に移行が正常に動作することを確認するために、$0.50 の無料トライアルクレジットを取得できます。
その他のガイド
質問と回答
DeepSeek API のベース URL は何ですか?
DeepSeek は独自のドキュメントで公開しているため、現在の値はそちらで確認してください。当サイトのエンドポイントは https://api.getdeepseekapi.com/v1 にある別のサービスです。
DeepSeek のキーをこのエンドポイントで使用できますか?
できません。キーはサービスごとに発行されます。キーページでこの API 用のキーを取得し、モデルを uncensored に設定してください。
ベース URL は /v1 で終わるべきですか?
このサービスの場合: https://api.getdeepseekapi.com/v1。SDKはその後エンドポイントパスを追加するため、/chat/completions を自分で追加しないでください。
URL を変更後に 404 エラーが発生するのはなぜですか?
通常、パスが重複しているか、/v1 が抜けています。ベース URL を上記の正確な値と比較してください。
キーはフォーム 1 つで手に入ります
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。