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、端點和路徑:三個部分
人們經常將完整網址貼上到期望前綴的欄位中,然後收到 404 錯誤。三個術語可協助釐清這些概念。
- 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 客戶端需要此完整 URL。
最容易讓人中招的規則:SDK 和應用程式要求輸入基礎 URL,而 curl 和 HTTP 節點要求輸入完整 URL。如果工具回報 404 錯誤,請先檢查是否將完整 URL 填入了預期基礎 URL 的位置,反之亦然。錯誤訊息中出現重複路徑(如 /v1/chat/completions/chat/completions)即是明確跡象。
DeepSeek Base URL 是什麼,以及它不是什麼
DeepSeek 在其文件中公布其 API 網址,以及其金鑰可用的模型名稱。請前往該處查看當前值,而非依賴部落格文章,包括本文。DeepSeek 金鑰僅對 DeepSeek 的端點有效,對其他端點無效。
本站的服務是一個獨立產品。它不是官方的 DeepSeek API,不轉發到 DeepSeek,也不提供 DeepSeek 模型。它是由獨立提供商運營的託管式 OpenAI 兼容 API,針對單一開放權重模型進行了調優,旨在為合法成人用戶提供無內容拒絕的回答。其地址為:
https://api.getdeepseekapi.com/v1 # model: uncensored
模型 ID 為 uncensored,驗證方式為 Authorization: Bearer <key>。金鑰在 API 金鑰頁面 發行。如果你正在比較金鑰對各項服務的意義,DeepSeek API 金鑰 頁面有更詳細的資訊。
在 OpenAI SDK 中切換端點
一旦更改基礎 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 會讀取兩個環境變數,因此現有應用程式可以無需程式碼變更即可重新指向:
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 基礎 URL、API 金鑰和模型。
相同的三值替換方法也適用於各種框架。例如在 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
許多聊天前端、編輯器和自動化工具都具有 "custom OpenAI-compatible endpoint" 選項。標籤不同,但字段一一映射:
| 應用程式欄位 | 說明 |
|---|---|
| API base、Base URL、Endpoint、Server URL | https://api.getdeepseekapi.com/v1 |
| API key、Token、Secret | 來自此服務的金鑰 |
| Model、Model name、Model ID | uncensored |
某些應用程式需要完整的聊天 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 token(提示詞加補全),最大請求主體為 8 MB。此服務僅支援文字:不支援圖片、音訊、嵌入向量或微調,因此依賴這些功能的特性需使用其他供應商。
計費也與舊供應商分開:預付額度每 1M 輸入 token 為 $0.15,每 1M 輸出 token 為 $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 與上述的精確值進行比較。
只差一張表單,即可取得金鑰
建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。