如何在 Cursor 中完成 gate.ai Cursor 的設定
Gate.AI 兼容 OpenAI 的接入方式允許開發者透過 Gate.AI API 金鑰、Gate.AI OpenAI 基礎 URL 以及支援的模型 ID，將 Cursor 連接至 Gate.AI（截至 2026 年 6 月）。對於希望將 Cursor Chat、Composer、Agent 或類似程式碼介面中的模型請求，改由 Gate.AI 而非預設模型供應商寄送的開發者而言，這項設定特別重要。本指南僅涵蓋 Cursor 的設定流程；若需了解更廣泛的 API 整合模式，請參閱Gate.AI API 整合指南。
前置條件
- 已安裝 Cursor。
- 已擁有 Gate.AI API 金鑰。
內容依據：Gate.AI 官方文件及附帶的 Cursor 設定截圖，截止 2026 年 6 月。
完成本指南後你能做什麼？
完成 gate.ai cursor 設定後，你將能在 Cursor 中新增 Gate.AI 作為自訂模型路由：輸入 Gate.AI API 金鑰與 OpenAI 相容基礎 URL，選擇如deepseek/deepseek-v3.2這類模型，並在 Cursor 的聊天或 Agent 介面中使用該模型。
本指南僅涉及 Cursor 介面設定。不涵蓋 SDK 整合、Claude Code 設定、Claude Desktop 設定，或企業權限設定。
步驟 1：打開 Cursor 設定
此步驟會開啟 Cursor 的設定區域，用於管理模型與 API 相關設定。
操作：在 Cursor 中，前往右上角並點擊設定圖示。Gate.AI 官方文件描述的 Cursor 入口路徑為右上選單 → 設定。
在更改模型設定前，請先從右上選單進入 Cursor 設定。
步驟 2：打開模型設定
此步驟會進入 Cursor 的模型設定頁面。
操作：在 Cursor 設定中，於左側選單選擇模型。若未顯示完整模型清單，請選擇查看全部模型。Gate.AI 官方文件列出新增自訂模型的 Cursor 路徑為模型 → 查看全部模型。
透過模型區塊管理內建模型、自訂模型與 API 設定。
步驟 3：點擊新增自訂模型
此步驟會為 Gate.AI 建立新的自訂模型條目。
操作：捲動至模型清單底部，點擊新增自訂模型。Gate.AI 官方文件說明 Cursor 設定路徑需捲動至底部並選擇新增自訂模型。
新增自訂模型後，將開啟可輸入 Gate.AI 模型 ID 的欄位。
步驟 4：輸入 Gate.AI 模型 ID
此步驟會告訴 Cursor 由哪一個 Gate.AI 支援的模型來處理請求。
操作：在 Cursor 中輸入 Gate.AI 模型 ID，然後點擊新增。採用provider/model-name格式，例如deepseek/deepseek-v3.2。Gate.AI 官方文件指出，Cursor 應從模型市集取得模型 ID，且設定時不應使用auto。
依據 Gate.AI 官方文件（截至 2026 年 6 月），模型 ID 採用provider/model-name格式，deepseek/deepseek-v3.2是支援的模型 ID 範例。
步驟 5：輸入 Gate.AI API 金鑰與基礎 URL
此步驟會將 Cursor 的 OpenAI 相容 API 欄位連接至 Gate.AI。
操作：在API 金鑰區塊，啟用OpenAI API 金鑰並貼上你的 Gate.AI API 金鑰。接著啟用覆寫 OpenAI 基礎 URL，並輸入：
xx/openai/v1
Gate.AI 官方文件列出xx/openai/v1為 OpenAI 相容基礎 URL，並強調正確的 API 路徑為/openai/v1，而非僅/v1。
在 Cursor 中輸入 Gate.AI 模型 ID、Gate.AI API 金鑰與xx/openai/v1基礎 URL。
步驟 6：在 Cursor Chat 中選擇 Gate.AI 模型
此步驟用於確認 Cursor 能夠在程式碼對話中使用 Gate.AI 模型。
操作：關閉 Cursor 設定，開啟 Cursor Chat、Composer、Agent 或其他對話介面，並在模型選擇器中選擇你新增的模型。Gate.AI 官方文件指出，新增的模型可在 Chat、Composer、Agent 與其他對話介面中選用。
你應能在模型選擇器中看到已設定的模型名稱，例如deepseek/deepseek-v3.2。
設定完成後，請在 Cursor 模型選擇器中選擇 Gate.AI 模型，再送出指令。
gate.ai cursor 設定應輸入哪些值？
| Cursor 欄位 | 輸入值 | 設定規則 |
|---|---|---|
| 自訂模型 ID | 範例：deepseek/deepseek-v3.2 | 使用 provider/model-name 格式，不要用 auto。 |
| OpenAI API 金鑰 | 你的Gate.AIAPI 金鑰 | 確認金鑰有效且複製無誤。 |
| 覆寫 OpenAI 基礎 URL | xx/openai/v1 | 使用 /openai/v1，而非僅 /v1。 |
| 模型選擇器 | 你新增的模型 | 測試指令前先選擇模型。 |
模型 ID 與基礎 URL 是 gate.ai cursor 設定中最關鍵的欄位。若 Cursor 能接受金鑰但無法路由請求，請先檢查模型 ID 格式與基礎 URL，再考慮變更其他設定。
Gate.AI 在 Cursor 中無法使用？故障排除清單
現象： Cursor 顯示
401或連線失敗。- 原因： Gate.AI API 金鑰無效、過期、被撤銷、已停用、複製錯誤，或帳戶餘額不足。
- 解法： 檢查 Gate.AI API 金鑰狀態，重新複製金鑰，確認帳戶餘額充足。Gate.AI 官方文件指出，API 金鑰無效與餘額不足是身分驗證或請求失敗的常見原因。
現象： Cursor 提示模型不可用或找不到。
- 原因： 模型 ID 拼字錯誤、未採用
provider/model-name格式，或輸入為auto。 - 解法： 從 Gate.AI 模型清單複製正確的模型 ID，並使用如
deepseek/deepseek-v3.2這種具體模型。
- 原因： 模型 ID 拼字錯誤、未採用
現象： Cursor 回傳未知的 API 路徑或 404 類錯誤。
- 原因： 基礎 URL 輸入為
https://api.gate.ai/v1或其他錯誤路徑。 - 解法： 將值改為
https://api.gate.ai/openai/v1。
- 原因： 基礎 URL 輸入為
現象： 自訂模型未出現在 Cursor Chat 中。
- 原因： 未儲存 Cursor 設定頁面，或 Cursor 未更新模型清單。
- 解法： 儲存設定、關閉設定、重新啟動 Cursor，然後再檢查模型選擇器。
現象： 某個模型可用，但另一個模型不可用。
- 原因： 所選模型與 Gate.AI 模型 ID 不完全符合，或受到帳戶或風控策略限制。
- 解法： 在 Gate.AI 官方文件中確認模型 ID 格式，並檢查帳戶或風控策略是否限制該模型。
下一步可以設定或開發什麼？
若需更廣泛的開發者整合流程，請參考Gate.AI API 整合指南。該指南詳細說明 Gate.AI API 接入在 OpenAI 相容開發流程中的作用。
官方設定參考請使用Gate.AI 文件。模型選擇請參閱Gate.AI 模型清單。如涉及預算或用量審核，請在生產環境設定前查看Gate.AI 價格。
常見問題
我可以在 Cursor 中使用auto作為模型 ID 嗎？
不行。Gate.AI 官方文件指出，Cursor 設定應使用模型市集中的具體模型 ID，而不應使用auto。
設定完成後要到哪裡選擇 Gate.AI 模型？
打開 Cursor Chat、Composer、Agent 或其他對話介面，然後在 Cursor 模型選擇器中選擇已新增的模型。
為什麼 API 金鑰在其他地方可用，但在 Cursor 不可用？
可能 Cursor 使用的是尚未儲存的模型條目、基礎 URL 錯誤，或模型 ID 不正確。請重新檢查模型 ID、API 金鑰開關、基礎 URL 開關與模型選擇器。
