繁中 ▾
取得 API 金鑰

如何在 Cursor 中使用 DeepSeek API:自訂 Base URL 設定

Cursor 可與任何 OpenAI 相容的端點通訊,因此你可以透過覆寫 base URL 並加入自訂模型名稱,搭配託管的 DeepSeek 風格 API 使用。本指南顯示需要填入的精確欄位及測試方法。

更新於

抽象程式碼編輯器面板透過發光電纜連接到 API 伺服器方塊

重點摘要

  • Cursor 的模型設定接受自訂 OpenAI base URL、API 金鑰和自訂模型名稱。
  • 使用 base URL https://api.deepseekapi.top/v1 和模型 ID uncensored。
  • 先用 curl 測試金鑰,這樣你就知道任何失敗都來自 Cursor 而非金鑰本身。
  • 費用為按量付費:每 1M 輸入 token 為 $0.15,每 1M 輸出 token 為 $0.50。

簡短答案

如果你想了解如何在 Cursor 中使用 deepseek api,流程與任何 OpenAI 相容的供應商相同。開啟 Cursor 的模型設定,將 API 金鑰貼入 OpenAI 金鑰欄位,覆蓋 OpenAI 的 Base URL,並加入 Cursor 尚未識別的模型名稱。然後在聊天中選擇該模型。

開始前的一個釐清。本站並非官方 DeepSeek API。這是一個託管的 OpenAI 相容文字 API,運行一個開放權重模型,由獨立供應商運營,並針對合法成人用途調整為無審查回答。模型 ID 為 uncensored。如果你需要官方 DeepSeek 服務,請改用該廠商的端點和金鑰。Cursor 中的設定看起來完全相同:只有這三個數值會改變。

Cursor 欄位說明
OpenAI API 金鑰來自 API 金鑰頁面 的金鑰
覆寫 OpenAI Base URLhttps://api.deepseekapi.top/v1
自訂模型名稱uncensored

開啟 Cursor 前:取得並測試金鑰

註冊可使用 Google 或電子郵件與密碼。之後,API 金鑰頁面有一個一鍵按鈕可新增 $0.50 的免費試用額度。有效期為 7 天,無需信用卡,每人限領一次。這足以應付幾百個短程式碼問題,讓你在付費前完成整個設定。金鑰頁面會引導你完成步驟。

現在在 Cursor 之外測試金鑰。Cursor 的錯誤訊息很短,金鑰的打字錯誤看起來與 URL 錯誤相同。在終端機中執行此指令:

curl https://api.deepseekapi.top/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
  }'

你應該會收到一個 JSON 回覆,函式位於 choices[0].message.content。你也可以使用 GET /v1/models 列出模型,這是確認金鑰被接受的快速方法。如果這運作正常,端點端已完成,剩下的就是 Cursor 設定。

逐步設定 Cursor

  1. 開啟 Cursor 設定並前往模型區段。在大多數版本中,你可以透過齒輪圖示,然後選擇模型來到達此處。
  2. 找到你的 OpenAI API 金鑰欄位並貼上金鑰。Cursor 可能會要求你驗證它。使用自訂端點時驗證可能會失敗,因為 Cursor 會將金鑰與其自身的模型列表進行比對。如果是這樣,請繼續下一步,並根據聊天是否運作來判斷。
  3. 開啟覆寫 OpenAI base URL 的選項,並輸入 https://api.deepseekapi.top/v1。包含結尾的 /v1。不要新增 /chat/completions;客戶端應用程式會自行附加該路徑。
  4. 使用新增模型控制項並精確輸入 uncensored,全部為小寫。在模型清單中啟用它。
  5. 開啟聊天面板,在模型選擇器中選擇 uncensored,並發送一段短提示詞。

選單名稱在 Cursor 版本之間會有所變化,因此如果標籤與上述不同,請尋找相同的三個項目:金鑰、base URL、自訂模型。Cursor 的文件是查詢目前名稱的地方。

一個需要注意的設定

Cursor 保留單一 OpenAI base URL 覆寫。當它開啟時,你在 Cursor 中使用的所有 OpenAI 命名模型都會指向新地址。如果你也想為其他用途使用不同的 OpenAI 相容服務,請關閉覆寫,或使用獨立設定檔。

自訂端點的功能

自訂金鑰用於呼叫聊天模型的功能:聊天面板和內嵌編輯。這些會發送標準聊天完成請求,這是此 API 接受的。服務支援透過 SSE 的串流輸出,因此回應會像其他供應商一樣,以 token 為單位出現在聊天面板中。

某些 Cursor 功能依賴 Cursor 自身的模型和伺服器,例如其Tab 自動完成。這些不會切換到你的金鑰。此外,Cursor 可能會在請求到達你的端點之前將其路由到其後端,因此如果網路位置或記錄對你很重要,請檢查其文件。在我們這邊,提示詞不會用於訓練。

代理風格功能依賴函式呼叫。API 支援帶有 tools、tool_choice 和串流 tool_calls 的函式呼叫,結果以 role: "tool" 返回。特定 Cursor 模式是否使用自訂模型的該路徑可能因版本而異,因此將其視為在小任務上測試的內容,然後再圍繞它建立工作流程。

上下文視窗為 100,000 個 token,包含提示詞和完成內容。這足以一次處理多個檔案,但 Cursor 決定附加什麼,而大的附件會在每則訊息中消耗輸入 token。

在編輯器中表現良好的提示詞

編輯器中的聊天模型,其價值取決於你提供的上下文。養成幾個好習慣,在使用任何透過自訂端點提供服務的模型時,都能產生顯著差異。

  • 僅附加必要的檔案。 每次對話輪次中,每個附加檔案都是輸入 token。兩份相關檔案在品質與成本上皆優於十份僅有鬆散關聯的檔案。
  • 說明任務和限制。 "重寫此函式以避免遞迴,保持簽名" 比 "讓它更好" 更有效。
  • 要求類似 diff 大小的回答。 如果你想要小變更,請說明。否則模型可能會重寫整個檔案,而你需要為輸出 token 付費。
  • 每個任務開始新的聊天。 舊的回合會被重新發送。乾淨的聊天是最便宜的上下文修剪方式。

該模型針對合法成人用途調整為無審查回答,因此與安全相關的程式碼問題(例如已知漏洞類別在你自己程式碼中的運作方式)往往會得到直接回答而非警告。它仍會像任何語言模型一樣犯錯。在提交任何內容之前,請閱讀它提供的程式碼並執行測試。

如果長回答卡住,請檢查下面的限制區段。試用金鑰上同時串流的兩個編輯器視窗會填滿兩個並行請求槽位,第三個請求會等待或返回 429。

編輯器的費用

價格為每 1M 輸入 token $0.15,每 1M 輸出 token $0.50,從預付額度扣除。沒有訂閱,失敗或拒絕的請求不會收費,且額度永不過期。

編輯器中的一個典型聊天回合有很多輸入(你附加的檔案加上歷史記錄)和短回答。假設 6,000 個輸入 token 和 700 個輸出 token:

  • 輸入:6,000 × $0.15 / 1,000,000 = $0.0009
  • 輸出:700 × $0.50 / 1,000,000 = $0.00035
  • 總計:每回合 $0.00125

在此規模下,100 次輪次費用為 $0.125。長達 400 次輪次的長時間工作天費用為 $0.50。一旦對話變長,輸入 token 是帳單主因,因為 Cursor 會重新發送歷史記錄。當你切換任務時,開啟全新對話是讓該數字保持最低的最簡單方法。

當你需要超過試用額度的金額時,儲值金額可為 $20 至 $500 之間的任意整數,並享有額外獎勵:$50 起 +5%,$100 起 +10%,$200 起 +15%。你可使用信用卡(Visa、Mastercard、Apple Pay、Google Pay)或加密貨幣(TRC20 上的 USDT、Base 上的 USDC)付款。詳情請見 定價頁面。

故障排除

401 或金鑰無效

金鑰貼上時帶有尾隨空格,或它屬於不同的網站。使用相同的字串重新執行 curl 測試。如果 curl 運作正常但 Cursor 不行,請再次貼上金鑰。

404 或找不到模型

通常 base URL 缺少 /v1 或在結尾有多餘的路徑。模型名稱必須精確為 uncensored。

429 回應

完整金鑰允許 8 個並行請求和每分鐘 300 個請求。試用金鑰允許 2 個並行請求和每分鐘 60 個請求。錯誤代碼 rate_limited 表示每分鐘請求過多,concurrency 表示同時請求過多。在暫時過載時,你也會收到帶有 Retry-After: 5 的 429。串流回應會保留其槽位直到串流結束,因此幾個同時串流的編輯器視窗可能會在試用金鑰上達到並行限制。

模型拒絕回答或偏離主題

該模型經過調整,以避免在合法成人用途時拒絕內容,但它仍是一個語言模型,且會遵循你的提示詞。提供清晰的系統指令和精確的任務。硬性限制是:涉及未成年人的性內容絕對禁止。

快速入門文件列出了每次回應傳回的標頭,包括 X-Request-Id,在聯繫支援時引用此標頭很有幫助。

問答

這是官方的 DeepSeek API 嗎?

不是。這是一個獨立的 OpenAI 相容服務,運行一個 ID 為 uncensored 的開放權重模型。它並非 DeepSeek 或其他廠商的官方 API。

在 Cursor 中試用需要信用卡嗎?

否。新用戶可在註冊後,於 API 金鑰頁面一鍵領取 $0.50 試用額度。有效期為 7 天,不需要信用卡。

為什麼 Cursor 顯示金鑰無法驗證?

Cursor 的驗證步驟可能會檢查其自身的模型列表。請使用 curl 測試金鑰,如果測試成功,請嘗試選擇自訂模型發送聊天訊息。

我可以從 Cursor 使用函式呼叫和 JSON 模式嗎?

API 支援這兩項功能,但 Cursor 功能是否將其發送至自訂模型,取決於 Cursor 的版本。建議先在小型任務上進行測試。

只差一張表單,即可取得金鑰

建立帳號、複製金鑰、更改自訂 Base URL 設定 URL。這就是整個設定過程。

取得 API 金鑰