如何使用 GitHub Copilot API 金鑰搭配 Cursor API

了解 API 金鑰相容性

當開發者提及 github copilot api key 時，通常指的是在 Microsoft GitHub 生態系統中生成的 token。此金鑰用於向執行 GPT-4o 或針對程式碼最佳化的專用變體的 Microsoft 伺服器進行請求驗證。雖然這些模型功能強大，但它們帶有與您的 Microsoft 帳戶綁定的特定內容篩選器和速率限制。

相比之下，Cursor API 作為獨立服務運作。它不依賴 Microsoft 基礎設施。相反地，它提供單一針對程式碼上下文最佳化的開放權重大型語言模型。該模型設計用於在法律允許的成人用途下無內容拒絕地回答，對於覺得標準篩選器具有限制性的開發者而言，這是獨特的替代方案。

了解此區別至關重要。您現有的 GitHub Copilot API 金鑰無法在 Cursor API 端點上使用。您需要從 cursorapikey.com 上的帳戶生成單獨的金鑰。不過，底層協議保持不變，意味著您的程式碼不需要大幅更改。

設定您的環境

要使用 Cursor API，你必須先產生金鑰。只需使用電子郵件和密碼在 取得 API 金鑰 頁面註冊。初始的免費試用額度不需要信用卡。註冊後，你的金鑰會立即顯示。將此金鑰安全地儲存到你的環境變數中，通常為 OPENAI_API_KEY 或根據你的代理程式需求設定的自訂變數。

大多數程式碼代理程式（包括 Cursor 和類似工具）都依賴 OpenAI SDK 標準。這意味著你不需要自訂函式庫。你只需將 SDK 指向正確的 Base URL 即可。Cursor API 的 Base URL 為 https://api.cursorapikey.com/v1。此端點完全相容 OpenAI，支援你已熟悉的請求結構。

請確保你的環境已設定為將請求傳送至這個新的 Base URL。你必須在請求中指定的模型 ID 為 uncensored。這會告訴 API 要呼叫哪個特定模型。這是一個開放權重模型，運行在我們自己的 GPU 伺服器上，與 GPT、Claude 或 Gemini 不同。

切換基礎 URL

從 GitHub Copilot API 金鑰切換至 Cursor API，主要需修改客戶端設定中的 Base URL。若使用官方 OpenAI Python 或 Node.js SDK，僅需修改一行程式碼。例如在 Python 中，使用新的 Base URL 與 API 金鑰初始化客戶端。

此變更會將你的請求從 Microsoft 的伺服器重新導向至我們的基礎設施。好處包括擁有 100,000 token 的上下文視窗，以及針對減少拒絕回應進行微調的模型。你可以透過檢查 /v1/models 端點來驗證連線，該端點應會回傳可用的模型，包括 uncensored。

權衡： 雖然語法相同，但你現在是依 token 付費，而非透過 Microsoft 訂閱。我們的定價透明：每 1M 輸入 token $0.25，每 1M 輸出 token $1.00。沒有月費，只需使用預付額度按用量付費，且額度永不過期。此模型適合變動的負載，你不需要承諾每月的席位成本。

測試您的連線

在將 API 整合到你的主要工作流程之前，必須驗證你的環境是否能與 Cursor API 通訊。你可以使用簡單的 cURL 指令或短腳本來進行測試。此測試可確保你的金鑰有效且 Base URL 正確。

cURL 請求範例：

向 https://api.cursorapikey.com/v1/chat/completions 發送 POST 請求，並將模型設為 uncensored。在 messages 陣列中包含簡單提示詞。成功回應將回傳 choices[0].message.content 欄位的補全內容。

如果收到 401 錯誤，表示你的 API 金鑰不正確。如果收到 429 錯誤，表示你已超過每個金鑰每分鐘 300 次請求的速率限制。你可以隨時重新產生金鑰以使舊金鑰失效。此測試確認基本的輸入文字、輸出文字功能運作正常。

處理串流輸出回應

對於程式碼代理程式而言，串流輸出對於提供流暢的使用者體驗至關重要。Cursor API 支援伺服器發送事件 (SSE) 進行串流輸出。這允許您在 token 生成時接收它們，而不是等待完整的回應。

使用 OpenAI SDK 時，您可以將 stream 參數設定為 true 來啟用串流輸出。SDK 將在資料到達時產生資料區塊。這對於長程式碼生成特別有用，您可以在其中向使用者顯示進度或將 token 餵入即時編輯器。

請注意，串流輸出不會改變底層模型或其功能。它純粹是一種交付機制。uncensored 模型仍將遵守 100,000 個 token 的上下文視窗和相同的定價結構。串流輸出是一種客戶端功能，可改善感知延遲，而不影響模型的行為。

工具呼叫整合

現代 AI 程式碼助手嚴重依賴工具呼叫（函式呼叫）來與外部世界互動，例如執行 shell 命令或存取檔案。Cursor API 透過標準 OpenAI 相容格式支援此功能。

您可以使用 tools 參數在請求中定義工具。如果模型判斷應使用工具，它將回應 tool_calls 陣列。您的應用程式必須執行工具並將結果在後續訊息中發送回 API。

此過程與您在 Microsoft 模型上使用 github copilot api key 的方式相同。這裡的優勢在於一致性。如果您已有用於工具呼叫的程式碼，您可能只需進行少量調整即可重複使用。只需確保您的工具定義符合 uncensored 模型的預期結構。

監控使用情況

由於您是按 token 付費，監控您的使用情況對於避免意外成本很重要。Cursor API 提供儀表板，您可以在其中查看您的額度餘額和使用歷史記錄。您可以查看已消耗的 token 數量以及剩餘的額度。

需留意的主要限制：

• 速率限制：每金鑰每分鐘 300 次請求。
• 請求主體大小：每個請求最大 8 MB。
• 上下文視窗：總共 100,000 個 token（輸入 + 輸出）。

如果您超過速率限制，將收到 429 錯誤。您可以即時監控您的使用情況，以確保您保持在這些限制內。此外，如果您懷疑金鑰已遭入侵，可以重新生成 API 金鑰，這會立即使舊金鑰無效。

常見問題排除

即使 API 很強大，也可能出現問題。以下是一些常見問題及其解決方案。

401 未授權： 檢查您的 API 金鑰。確保其複製正確且沒有前導或尾隨空格。如果您重新生成了金鑰，請確保您使用的是新金鑰。

429 請求過多： 您已超過每分鐘 300 次請求的限制。在您的客戶端中實施指數退避或減少請求頻率。

400 錯誤請求： 這通常表示 JSON 負載格式錯誤或缺少必要欄位。確保您的 messages 陣列格式正確，並包含 role 和 content 欄位。此外，請驗證模型名稱是否完全為 uncensored。

內容封鎖： 雖然模型是無審查的，但它會封鎖涉及未成年人的性內容。如果你的請求被封鎖，可能是因為這個特定的硬性限制。