繁中 ▾
取得 API 金鑰

cursorapikey.com/指南

如何使用 Cursor API 金鑰搭配自訂端點

以下是如何使用 Cursor API 設定搭配您自己的端點:貼上金鑰、覆寫 OpenAI Base URL,並加入模型名稱 uncensored。以下步驟約需五分鐘,並包含您可以先執行的 curl 檢查。

更新於

等距程式碼編輯器透過發光電纜連接至伺服器方塊,說明自訂 API 端點

重點摘要

  • Cursor 讓您可覆寫 OpenAI Base URL 和金鑰,因此任何 OpenAI 相容的端點都能處理請求。
  • 使用 Base URL https://api.cursorapikey.com/v1 與模型 ID uncensored。
  • 在調整編輯器之前,先用 curl 測試金鑰,以便知道故障來自哪一側。
  • 20,000 token 的提示詞搭配 1,000 token 的回答,費用為 $0.0035。

本指南涵蓋的內容

搜尋如何使用 Cursor API 的人通常指兩種情況。一是希望從程式碼呼叫某些 Cursor 服務,二是希望 Cursor 編輯器將其模型請求發送至您選擇的端點。本指南針對第二種情況。本站是獨立託管的 API,支援 OpenAI 聊天完成協定,因此 Cursor 可以像與任何 OpenAI 風格伺服器通訊一樣與它通訊。

後端的模型是單一開放權重模型,由獨立供應商運行,並針對合法成人用途進行調整以無內容拒絕地回答。它不是官方的 Cursor 模型,也不是跨供應商的路由器。它僅處理文字。對於程式碼編寫通常已足夠:您發送程式碼和指示,您會收到程式碼和解釋。

您需要三樣東西:API 金鑰、Base URL https://api.cursorapikey.com/v1,以及模型 ID uncensored。其餘只是找到編輯器中的正確欄位。

步驟 1:取得金鑰並用 curl 檢查

使用 Google 或電子郵件與密碼註冊,然後開啟 API 金鑰頁面。新帳戶可以一鍵領取 $0.50 的免費試用額度。無需信用卡,有效期為 7 天。試用金鑰限制為 2 個並行請求和每分鐘 60 個請求,這足以進行編輯器的首次會話。

在開啟 Cursor 之前,確認金鑰是否有效。在終端機中執行此命令,將您的金鑰放在環境變數中:

export API_KEY="paste-your-key-here"

curl https://api.cursorapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

curl https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write a Python function that reverses a linked list."}
    ]
  }'

第一次呼叫列出模型。第二次回傳正常的聊天完成。如果兩者都成功,編輯器中後來的任何故障都是設定問題,而非金鑰問題。這種區分可節省大量猜測。

步驟 2:在 Cursor 中設定 Base URL 和金鑰

開啟 Cursor 的設定並前往模型區段。選單名稱和版面配置在版本之間會有所變化,因此請將下方的標籤視為地圖,如果有任何變更,請檢查 Cursor 的官方文件。

  1. 找到 OpenAI API 金鑰的欄位,並貼上來自本站的金鑰。
  2. 啟用覆寫 OpenAI Base URL 的選項,並輸入 https://api.cursorapikey.com/v1。保留結尾的 /v1,不要新增 /chat/completions;客戶端應用程式會自行附加路徑。
  3. 新增自訂模型並精確輸入 uncensored,全部小寫。
  4. 如果編輯器提供驗證或儲存按鈕,請使用它們,然後在聊天面板中選擇新模型。

發送短訊息,例如「解釋這個函式」,並開啟檔案。串流輸出表示路由端到端運作。Cursor 發送請求,端點透過 SSE 串流輸出 token,編輯器會即時渲染它們。

兩個注意事項。某些編輯器功能,例如內嵌 Tab 自動完成,可能在 Cursor 控制的模型上運行,並可能忽略您的金鑰,因此請檢查哪些功能實際使用自訂模型。由於 Cursor 可能透過其伺服器路由自訂金鑰流量,如果需要知道程式碼確切去向,請閱讀其目前的文件。本站的 快速入門列出了 API 端的合約。

從程式碼測試相同的端點

隔離問題的最簡單方法是使用官方 OpenAI SDK 呼叫端點。如果這有效,端點沒問題,任何剩餘問題都在編輯器設定中。

from openai import OpenAI

client = OpenAI(
    api_key="paste-your-key-here",
    base_url="https://api.cursorapikey.com/v1",
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a terse senior engineer."},
        {"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n    if x > 0:\n        out.append(x * 2)"},
    ],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node 中的相同操作:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.cursorapikey.com/v1",
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});

console.log(res.choices[0].message.content);

串流回應會在結尾包含用量資訊,因此你可以精確記錄每個請求使用了多少 token。每個回應也會帶有 X-Balance-USD 標頭,顯示你的剩餘額度,以及 X-Request-Id,若出現異常可引用此 ID。

程式碼工作流程中的可用功能

API 支援串流輸出、JSON 模式與函式呼叫(tools、tool_choice、串流 tool_calls,以及以 role: "tool" 格式回傳的結果)。採樣設定如 temperature、top_p、stop、seed 以及懲罰因子都會直接傳遞。上下文視窗為 100,000 token,提示詞與補全內容共用此視窗,且 max_tokens 為選填欄位。

100,000 token 對於程式碼來說是寬鬆的預算。幾百行的原始碼檔案只有幾千個 token,因此您可以包含多個檔案加上長指示,並為回答保留空間。最大請求主體為 8 MB,以文字來說您不會達到。

讓自訂模型在編輯器中愉快的習慣:

  • 程式碼編輯時請保持較低的 temperature。數值約 0.2 時輸出較穩定;僅在腦力激盪時才調高。
  • 僅附加重要的檔案。您發送的每個 token 都會作為輸入計費,且整個對話會在每次輪次中重新發送。
  • 當檔案很長時,要求 diff 或變更的函式,而不是整個檔案。輸出 token 的成本高於輸入 token。
  • 對於拒絕會造成阻礙的任務使用模型,例如為您自己的實驗室撰寫漏洞概念驗證、分析您獲授權研究的惡意軟體範例,或生成模擬真實世界令人不適的內容的測試資料。所有內容都必須合法。

一個值得重複的硬性限制:任何情況下都不允許涉及未成年人的性內容。

修復常見錯誤

症狀可能原因修復方法
401 或「無效金鑰」金鑰貼上時帶有空白,或為舊金鑰從金鑰頁面重新複製;用 curl 測試
404 或「找不到模型」模型名稱輸入不同使用 uncensored,全小寫,不加後綴
路徑上的 404Base URL 包含 /chat/completionsBase URL 以 /v1 結尾
429 錯誤與 concurrency 相關同時請求過多等待串流請求結束;完整金鑰允許 8 個,試用金鑰允許 2 個
429 錯誤且rate_limited每分鐘超過 300 個請求(試用金鑰為 60 個)降低請求頻率,或暫停後重試
429 帶有 Retry-After: 5暫時過載五秒後重試

串流中的請求會佔用並行槽位,直到串流結束。如果你在 Cursor 中開啟多個聊天並讓它們持續生成,試用金鑰很快就會達到並行限制。失敗或遭拒的請求不會計費,因此重試不會產生額外費用。

程式碼會話的成本

計費標準為每 1M 個輸入 token $0.15,每 1M 個輸出 token $0.50,從預付額度中扣除,無訂閱費。典型的編輯器請求包含龐大的提示詞(你的檔案)和短的回答。假設使用 20,000 個輸入 token 和 1,000 個輸出 token:

  • 輸入:20,000 x $0.15 / 1,000,000 = $0.0030
  • 輸出:1,000 x $0.50 / 1,000,000 = $0.0005
  • 總計:每次請求 $0.0035

在一個工作日內進行 100 次請求,費用為 $0.35。$0.50 的試用額度可涵蓋約 140 次此類請求。試用期結束後,你可以儲值 $20 至 $500 之間的任意整數金額,儲值達 $50 起贈送 +5% 額度,達 $100 贈送 +10%,達 $200 贈送 +15%。支援加密貨幣(TRC20 上的 USDT、Base 上的 USDC)付款。額度永不過期,因此慢慢使用的儲值不會浪費。定價頁面有完整表格,Cursor 與 Copilot 替代方案頁面則說明此服務在訂閱型編輯器旁的定位。

提示詞不會用於訓練。

01

問答

這與 Cursor 代理程式和函式呼叫相容嗎?

API 支援使用工具的函式呼叫,包含 tool_choice 和串流輸出的 tool_calls。特定 Cursor 功能是否使用你的自訂模型取決於編輯器,因此設定後請測試每個功能。

我要輸入哪個模型名稱?

輸入 uncensored(全小寫)。這是唯一的模型 ID,且 GET /v1/models 會列出該模型。

這是官方的 Cursor API 嗎?

不是。它是位於單一開放權重模型之前的獨立 OpenAI 相容 API。Cursor 只是讓你將其 OpenAI 設定指向不同的端點。

試用需要信用卡嗎?

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

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

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