繁中 ▾
取得 API 金鑰

cursorapikey.com/指南

Cursor API 金鑰無法運作:自訂端點修復

當 Cursor API 金鑰無法運作時,原因幾乎總是以下四種之一:基本 URL、模型名稱、金鑰本身,或帳戶的速率限制。一條 curl 指令即可告訴你哪一個是問題所在。

更新於

抽象程式碼編輯器面板,顯示發光的金鑰正在被插入,旁邊有扳手和放大鏡
等距分支圖,顯示通往編輯器、伺服器與終端機的路徑,說明選擇 Cursor 的替代方案

重點摘要

  • 先用 curl 在 Cursor 之外測試金鑰;如果 curl 正常,問題出在 Cursor 設定。
  • 基本 URL 必須是 https://api.cursorapikey.com/v1,且模型名稱必須完全為 uncensored。
  • 401 代表金鑰錯誤,404 代表 URL 錯誤,429 代表速率或並行請求限制,模型錯誤則代表名稱錯誤。
  • 選單標籤在 Cursor 不同版本間會有所差異,因此請對照欄位用途,而非字詞是否完全相同。

步驟 1:在 Cursor 之外測試金鑰

先排除 Cursor 的干擾。如果單純請求成功,表示你的金鑰和帳戶都沒問題,故障在於編輯器設定。如果失敗,錯誤訊息會指出問題所在。

curl -i https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'

-i 旗標會印出狀態行與標頭。200 狀態且包含 choices 陣列表示成功。X-Balance-USD 標頭會顯示您的剩餘額度,若出現授權或付款錯誤,這是第一個應檢查的項目。

你也可以列出模型,這會確認金鑰且不會花費任何費用:

curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored

回應應包含模型 ID uncensored。

步驟 2:在 Cursor 中設定欄位

開啟 Cursor 的設定並找到模型區段。你需要三個數值,其中任何一個出錯都會導致看起來像金鑰損壞的失敗。

  1. OpenAI API 金鑰: 貼上你的金鑰,兩端不得有空格或換行。
  2. 覆寫 OpenAI Base URL: 開啟覆寫並輸入 https://api.cursorapikey.com/v1。保留 /v1 並移除 /chat/completions。
  3. 自訂模型: 新增名為 uncensored 的模型並啟用。停用你不使用的模型,以免 Cursor 選取端點不認識的模型。

儲存後,如果你的版本有驗證選項,請使用它,然後在聊天模型下拉選單中選擇 uncensored。開啟新的聊天分頁是一個好的測試方式,因為舊分頁可能會保留其初始的模型。如何使用 Cursor API 中的逐步指南展示了具有更多上下文的相同設定。

根據錯誤對應修復方法

您會看到的內容可能原因修復方法
401,「無效金鑰」,「未授權」金鑰輸入錯誤、截斷或已撤銷從金鑰頁面再次複製;檢查是否有尾隨空格
404,「找不到」URL 錯誤、缺少 /v1 或路徑重複請精確使用 https://api.cursorapikey.com/v1
"找不到模型"或類似訊息模型名稱與 uncensored 不同新增具有該 exact name 的自訂模型,全部小寫
429 錯誤且rate_limited超過每分鐘請求數限制放慢速度;試用金鑰每分鐘允許 60 次請求,完整金鑰每分鐘 300 次
429 錯誤與 concurrency 相關同時請求過多減少並行代理程式執行次數;試用版 2,完整金鑰 8
429 帶有 Retry-After: 5暫時過載等待五秒後重試
curl 正常,但在 Cursor 中失敗設定未儲存、分頁模型錯誤,或該功能不使用自訂金鑰請見下一節

失敗或被拒絕的請求不會收費,所以在除錯時重試不會產生費用。

當 curl 正常但 Cursor 仍然失敗時

這是最令人困惑的情況,通常有幾種解釋。

選錯了模型。 Cursor 會在清單中保留其內建模型。如果選取了其中一個,請求根本不會發送到你的端點。請在所使用的聊天或編輯器下拉選單中明確選擇 uncensored。

並非所有功能都使用你的金鑰。 依賴 Cursor 自有模型的功能(例如內嵌自動完成)可能會繼續使用它們,無論你新增的金鑰為何。自訂金鑰適用於你可以選擇模型的地方,也就是聊天和編輯模式。請檢查 Cursor 目前的文件,因為這會隨版本變更。

代理模式的並行請求。 代理程式和多步驟執行可以同時觸發多個請求。試用金鑰允許同時兩個請求。如果錯誤僅出現在代理模式,你可能已觸及 concurrency 限制,完整金鑰可將其提高至八個。串流請求會佔用其槽位直到串流結束,因此長輸出會佔用槽位更久。

函式呼叫。 API 支援函式呼叫,tool_calls 會以串流輸出,結果以 role: "tool" 傳回。函式使用的品質取決於模型,因此如果代理程式執行在函式步驟卡住,請先在純聊天中嘗試相同任務。

檢查帳戶端

如果 curl 回傳關於餘額的錯誤,表示金鑰有效但餘額已空或試用已結束。試用額度為 $0.50,有效期 7 天,可在註冊後於 API 金鑰頁面以一次點擊領取。之後你需要儲值。

儲值金額為 $20 至 $500 的整數金額,從 $50 起加贈 5%,從 $100 起加贈 10%,從 $200 起加贈 15%。你可以使用加密貨幣(TRC20 上的 USDT、Base 上的 USDC)付款。定價頁面 顯示了表格。如果你還沒有金鑰,在此取得。

每個工具保留一個金鑰。如果你將金鑰貼到多個編輯器和腳本中,速率限制會共享,這看起來像是隨機失敗。

頑固案例的腳本檢查

如果你仍然無法找到原因,請執行一個模擬編輯器行為的短腳本。它使用 OpenAI SDK,Cursor 風格的客戶端就是基於此建模的,並會印出確切的錯誤物件。

from openai import OpenAI, APIStatusError

client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
        stream=True,
    )
    for chunk in r:
        print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
    print(e.status_code, e.response.headers.get("X-Request-Id"))
    print(e.response.text)

如果腳本串流輸出文字,表示端點、金鑰和模型都正確,剩餘的問題是 Cursor 設定。如果它印出狀態碼,請使用上方的表格。聯繫支援時請保留 X-Request-Id 值,因為它可識別確切的請求。完整參數詳情位於 文件頁面。

防止再次出錯

一些習慣可以防止大多數重複問題。將金鑰儲存到一個密碼管理器項目中並從那裡複製,而不是從聊天記錄或筆記中複製,因為後者容易混入換行符號。寫下三個數值(基本 URL、金鑰、模型名稱),以便在編輯器更新後重新輸入,因為更新有時會重置覆寫。每次更新後,在開始實際工作前先發送一條短聊天訊息。

監控餘額。X-Balance-USD 標頭會在每個回應中回傳,你也可以從 GET /v1/balance 讀取。額度永不過期,因此帳戶中保留適度的儲值不會浪費。如果你也從腳本中使用金鑰,請為長批次作業提供重試迴圈,在 429 錯誤時等待五秒並在幾次嘗試後停止,以免腳本佔用編輯器的並行槽位。

包含 10,000 token 檔案上下文的程式設計聊天請求,加上 700 token 的回答,輸入成本為 10,000 / 1,000,000 x $0.15 = $0.0015,輸出成本為 700 / 1,000,000 x $0.50 = $0.00035,總計約 $0.00185。費率為每 1M 輸入 token $0.15,每 1M 輸出 token $0.50。Cursor API 定價 文章涵蓋每月估算。

如果失敗的請求是大型請求,請記住視窗限制:提示詞加上補全必須在 100,000 token 以內,且請求主體上限為 8 MB。將整個儲存庫附加到聊天可能會同時超過這兩項限制。僅保留重要的檔案上下文並重試。

01

問答

為什麼 Cursor 說我的 API 金鑰無效?

通常金鑰有多餘的空格或只複製了部分,或者 Base URL 仍指向其他服務。重新複製金鑰,然後確認覆寫 URL 為 https://api.cursorapikey.com/v1.

我要輸入哪個模型名稱?

以小寫輸入 uncensored。這是 API 提供的唯一模型 ID。

自動完成會使用我的金鑰嗎?

不一定。部分 Cursor 功能使用 Cursor 自己的模型,而使用者提供的金鑰主要適用於聊天和編輯模式,在這些模式中你可以選擇模型。

失敗的請求會計費嗎?

不會。失敗或被拒絕的請求不會計費,因此在除錯時重試不會產生費用。

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

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