你正在設定的內容
Cursor 是一款支援自訂模型供應商的編輯器。如果你提供 OpenAI 風格的 Base URL、金鑰和模型名稱，它會將聊天請求發送到該處，而非預設供應商。此服務支援該協定：POST /v1/chat/completions（Bearer 驗證），以及 GET /v1/models。
兩件事需事先釐清。這是獨立運行的 API，使用單一開放權重模型，並非 OpenAI 的 Codex，也不是 Cursor 的官方產品。Cursor 經常變更設定畫面，因此下方的標籤在你的版本中可能位於稍有不同的位置。這三個值永遠不會改變：Base URL、金鑰、模型名稱。
步驟 1：取得金鑰並在 Cursor 之外測試
在 API 金鑰頁面 使用 Google 或電子郵件與密碼註冊。新帳戶可一鍵領取 $0.50 免費試用額度，有效期 7 天，無需信用卡。這足以測試編輯器設定。
在調整 Cursor 之前，請確認金鑰是否有效。編輯器內的錯誤比終端機中的錯誤更難閱讀。
curl https://api.getcodexapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
}'如果你收到包含狀態碼的 JSON 回覆，請繼續進行。如果你收到錯誤，請先在此修復。常見原因包括金鑰中缺少字元，或在結尾處貼上了空白字元。
步驟 2：設定 Cursor
- 開啟 Cursor 設定並前往模型區段。
- 找到 OpenAI API 金鑰欄位，並貼上此服務的金鑰。
- 開啟覆寫 OpenAI Base URL 的選項，並輸入
https://api.getcodexapi.com/v1。 - 新增自訂模型並輸入精確名稱
uncensored。 - 如果有驗證按鈕，請點擊驗證，然後開啟聊天面板並從模型清單中選擇
uncensored。
如果驗證步驟顯示失敗，請依序檢查三件事：Base URL 以 /v1 結尾且其後無端點路徑、金鑰貼上時無尾隨空白、模型名稱無大寫字母。說明文件頁面 列出了相同的值與額外的客戶端範例。
需規劃的一點：覆寫是設定，而非每模型選項，因此如果你在 Cursor 其他地方也使用自己的 OpenAI 金鑰，請先關閉覆寫。請記錄你所做的變更。
儲存後，在聊天中向模型提出簡單的程式碼問題並觀察回覆。首次回覆較慢是正常的，因為 Cursor 正在建構請求。如果收到回覆，表示已連接，下一步是在你自己的程式庫中進行實際工作測試。
哪些請求會通過你的金鑰，哪些不會
Cursor 混合了多種功能。聊天和內嵌編輯請求是最可能使用你自訂模型的功能（一旦你選擇它）。其他功能（如分頁自動完成）歷史上使用 Cursor 自行運行的模型，而代理程式樣式功能可能取決於 Cursor 處理工具的方式。誠實的做法是嘗試你依賴的功能並觀察餘額。
這很容易做到：此 API 的每個回覆都帶有 X-Balance-USD 標頭，且你的餘額在帳戶中可見。如果你發送聊天訊息且餘額未變動，表示該請求未發送給我們。
此端點支援函式呼叫（tools、tool_choice、串流輸出 tool_calls，以及結果為 role: "tool"），這是編輯代理程式所需的功能。串流輸出透過伺服器發送事件（SSE）運作，設定 stream: true。上下文視窗為 100,000 token（提示詞與補全合計），因此大型檔案及其鄰近內容可包含在單一請求中。
為什麼在編輯器中使用無審查模型
大多數程式碼工作不會觸發拒絕。當確實發生時，通常是因為合理的任務在謹慎的過濾器看來具有風險：為你自己的網路撰寫埠掃描器、分析你正在檢查的惡意軟體樣本、生成包含冒犯性語言的測試資料、為成人角色扮演或陪伴應用程式建立後端，或重構處理內容審核的程式碼。此模型經過調整，可在合法成人用途下無內容審查地回答。
它仍是單一通用開放權重模型，而非專門的程式碼模型，且此處不保證它在你的程式碼庫上優於任何特定替代方案。讓你的任務通過它運行。有一條規則固定不變：不涉及未成年人的性內容，且無法更改。
實際成本
費率為每 1M 輸入 token $0.15，每 1M 輸出 token $0.50，從預付額度扣款，無訂閱費。編輯器流量以輸入為主，因為每個請求都會重新發送檔案上下文。
一個包含 8,000 輸入 token 和 1,000 輸出 token 的請求，輸入成本為 8,000 x $0.15 / 1,000,000 = $0.0012，輸出成本為 1,000 x $0.50 / 1,000,000 = $0.0005，總計 $0.0017。如果你一天進行 150 次此類請求，總計 150 x $0.0017 = $0.255，約 26 分錢。
發送 40,000 個 token 的上下文並取得 1,500 個 token 的請求，費用為 $0.006 + $0.00075 = $0.00675。儲值金額自 $20 起，且額度永不過期，因此沒有必須用完的壓力。請見 定價頁面 了解優惠方案，並參閱 程式設計 API 頁面 取得總覽。
編輯使用的速率限制
完整金鑰允許 8 個並行請求和每分鐘 300 個請求。試用金鑰允許 2 個並行和每分鐘 60 個請求。一個人在單一編輯器中打字很少會接近這些限制，但團隊共用一個金鑰，或代理程式並行發送許多請求時可能會超過。當超過限制時，API 會返回 HTTP 429。程式碼 rate_limited 表示每分鐘請求過多，concurrency 表示同時請求過多。如果服務短暫過載，你也會看到帶有 Retry-After: 5 的 429。
串流聊天會佔用其並行槽位直到串流結束。對於共用使用，請為每位開發人員提供自己的金鑰，而非團隊共用一個金鑰。
疑難排解檢查清單
- 找不到模型。 重新輸入
uncensored，無空格。移除你不使用的舊自訂模型。 - 驗證錯誤。 重新複製金鑰。確保 Cursor 未仍在使用來自其他供應商的金鑰。
- 回覆提前停止。 檢查 Cursor 是否設定了自己的輸出上限。在我們這邊，
max_tokens是可選的。 - 餘額無變化。 你使用的功能未通過你的自訂金鑰路由。請改用聊天。
- 頻繁 429。 降低並行請求，或使用完整金鑰而非試用金鑰。
