繁中 ▾
取得 API 金鑰

getdeepseekapi.com指南

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 和金鑰。
鐵路開關將發光的軌道重定向到不同的伺服器,說明切換 API Base 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 APIPOST 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 URLhttps://api.getdeepseekapi.com/v1
API key、Token、Secret來自此服務的金鑰
Model、Model name、Model IDuncensored

某些應用程式需要完整的聊天 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。這就是整個設定過程。

取得 API 金鑰