Cursor 內建就能直接使用幾家模型,但設定裡也提供了指向自訂 OpenAI 相容端點的選項——如果團隊已經有一組涵蓋多家模型供應商的閘道金鑰,就不需要另外為編輯器單獨訂閱一套模型服務。
這個設定放在哪裡
Cursor 的模型設定裡,有針對 OpenAI 相容模型覆寫 API base URL 與金鑰的選項(Claude 系列另外有 Anthropic 相容的欄位)。不同版本的 Cursor,選單標示的文字位置會略有調整,與其照著舊版截圖找,不如直接在設定裡搜尋「API Key」或「Override」關鍵字比較穩妥。
這裡的「OpenAI 相容」具體是指什麼?
Cursor 的自訂供應商欄位,預期收到跟 OpenAI Chat Completions API 一樣的請求與回應格式。只要閘道說的是同一種格式,不管上游實際處理請求的是哪個模型,Cursor 都不需要知道背後換了供應商。
設定步驟
- 打開 Cursor 設定,找到模型供應商區塊。
- 啟用 OpenAI 相容模型的自訂 API 覆寫選項。
- 貼上閘道的 base URL。
- 貼上閘道的 API Key。
- 選擇(或手動輸入)要預設使用的模型字串。
- 在新的對話裡送一則測試訊息,確認真的走覆寫路徑,而不是悄悄退回 Cursor 內建供應商。
怎麼確認覆寫真的生效了?
最可靠的方式是看用量歸屬:送出測試訊息之後,如果閘道後台的用量儀表板馬上出現對應紀錄,代表覆寫已經生效。如果過了一段時間都沒有紀錄,代表 Cursor 很可能還在用內建預設供應商。
常見設定錯誤
| 錯誤 | 會發生什麼 | 怎麼修正 |
|---|---|---|
| base URL 多貼了給其他 SDK 用的路徑片段 | 請求回傳 404 或格式異常的回應 | 完全照閘道文件標示的 base URL 貼上,不要額外附加路徑 |
| API Key 貼上時前後多了空白字元 | 出現看起來像 Cursor 問題的 401 錯誤 | 直接從後台複製金鑰貼上,避免手動重新輸入 |
| 模型字串跟閘道對應不上 | 出現「找不到模型」之類的錯誤 | 從閘道支援模型清單複製完整字串,不要憑印象打 |
為什麼要讓 Cursor 走閘道,而不是用內建模型?
最常見的兩個理由是模型選擇跟帳單整併。Cursor 內建選項必然是精選過的子集;而一個涵蓋 Claude、GPT、DeepSeek、GLM、Kimi、通義千問、Llama、Grok 的閘道,可以依任務挑模型,而不是被綁在編輯器預設值上,花費也能併進同一份帳單,不用跟編輯器訂閱分開對帳。
只是偶爾用到 Cursor,值得特別設定嗎?
如果使用頻率不高,用內建預設通常就夠簡單。覆寫設定真正划算的時機,是已經在別處付費使用閘道金鑰、希望 Cursor 也併進同一份帳單的時候,或是確實需要一個 Cursor 預設沒有提供的模型。
PioModel 的 API Key 可以直接貼進 Cursor 的自訂供應商欄位使用,因為端點本身就是設計成 OpenAI 相容格式,中間不需要額外的轉譯層。
Comments
Sign in to join the discussion