在 Cursor 使用自己的 API Key 與 Base URL
把 RelaySwitch 的金鑰貼進 Cursor 的 OpenAI API Key，再把 Base URL 覆寫為 https://api.relayswitch.io/v1，金鑰上的每個對話模型都能加進模型選單。Agent 與 Ask 兩種模式都能用，費用從預付餘額按 token 扣款。
01Cursor 為什麼能換 API Key
Cursor 送出的是 OpenAI 格式的請求，而模型列表上的每個對話模型都回應這種格式。所以一把金鑰就能讓 Claude、GPT、Gemini、DeepSeek 出現在同一個選單裡，各自依即時的 token 價格，從同一筆預付餘額扣款。金鑰怎麼取得，見 Claude API Key。
02設定步驟：Cursor Settings 的 Models
一共五個步驟，三個欄位填好之後的樣子在本節最後。
- 開啟 Cursor Settings（
Cmd/Ctrl + ,），進入 Models。金鑰與 Base URL 的欄位在模型清單下方。 - 打開 OpenAI API Key 的開關，貼上從控制台複製的完整金鑰。
- 打開 Override OpenAI Base URL，填
https://api.relayswitch.io/v1，結尾要帶/v1。 - 按 Save（舊版的按鈕叫 Verify）。
- 在 Models 底下逐一加入想用的模型 id，要和模型列表上顯示的 id 完全一致，不是顯示名稱；Claude 的 id 也可以。然後在對話面板選一個。
OpenAI API Key: sk-relay-...Override OpenAI Base URL: https://api.relayswitch.io/v1Models: gpt-6.1-sol03三個欄位各自的作用
| OpenAI API Key | Cursor 隨每次請求送出的憑證。貼上控制台裡的完整金鑰。 |
| Override OpenAI Base URL | 把這些請求改送到 https://api.relayswitch.io/v1，而不是 OpenAI。 |
| Models | 選單會列出的模型。把想用的 id 逐一加進去，寫法要和模型列表上的一致。 |
04先用 curl 確認金鑰
Cursor 裡出錯時，先繞過它，用和 Cursor 相同的方式送一個請求。回應標頭裡有這次請求的 id；非串流的回應還會帶上這次扣款的美元金額。
這個請求回覆 200，就表示金鑰與網址沒問題。接著回到 Cursor，選好模型送一則訊息：請求會出現在控制台的用量頁，附上 token 數與扣款。
curl https://api.relayswitch.io/v1/chat/completions \ -H "Authorization: Bearer sk-relay-..." \ -H "content-type: application/json" \ -d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Reply with ok"}]}'05Agent 模式與 GPT 模型
開啟 Base URL 覆寫之後，Cursor 的 Agent 模式會把 Responses API 的請求內容送到 Chat Completions 的路徑給 GPT 模型；Cursor 在自己的論壇把這列為已知問題。閘道會把這段內容當成它所代表的 Chat Completions 請求來解讀，並以 Chat Completions 格式回覆，串流與否都一樣。所以 GPT 的 id 在 Agent 與 Ask 模式都能用，價格不變。
Cursor 預設使用串流輸出，沒有開關；所有模型都支援串流。
06挑模型與計費
Agent 的請求會帶上整段對話、Cursor 讀過的檔案與工具結果，所以帳單大部分是輸入 token，輸入單價低的模型每次請求花得最少。本節最後是幾個主力模型的即時價格，單位為美元／每百萬 token。
- 請求依模型的價格按 token 計費，從預付餘額扣款。
- 回應回報有快取輸入 token 時，這部分以模型的快取價計費，而不是輸入價；反覆送出相同開頭的長對話，每一輪會比全新的對話便宜。
- 在 Cursor 的 Teams 與 Enterprise 方案，Cursor 會把自帶金鑰的請求計入它的用量，並加收它自己的每 token 費用；這筆費用由 Cursor 收取，不在這裡。依 Cursor 的 API key 文件，個人方案不計入。
| 模型 | 開發商 | 輸入 | 輸出 | 上下文長度 |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00≈ NT$134.44 | $20.00≈ NT$672.18 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716≈ NT$91.28 | $9.70≈ NT$326.01 | 1,000,000 |
| DeepSeek V4.1 Flash 1017deepseek-v4.1-flash-1017 | DeepSeek | $0.2425≈ NT$8.15 | $1.164≈ NT$39.12 | 1,048,576 |
| GLM 5.3 Flashglm-5.3-flash | Z.ai | $0.0873≈ NT$2.93 | $0.1455≈ NT$4.89 | 1,000,000 |
| GPT-6 Lunagpt-6-luna | OpenAI | $0.0625≈ NT$2.10 | $0.20≈ NT$6.72 | 1,050,000 |
| Qwen3.8 Maxqwen3.8-max | Qwen | $0.80≈ NT$26.89 | $2.40≈ NT$80.66 | 991,000 |
| Minimax M3.1 Flashminimax-m3.1-flash | MiniMax | $0.105≈ NT$3.53 | $0.42≈ NT$14.12 | 1,000,000 |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925≈ NT$16.55 | $2.25≈ NT$75.62 | 1,048,576 | |
| Grok 4.7grok-4.7 | xAI | $0.60≈ NT$20.17 | $1.80≈ NT$60.50 | 500,000 |
| Kimi K3kimi-k3 | Moonshot AI | $0.90≈ NT$30.25 | $4.50≈ NT$151.24 | 1,048,576 |
美元／每百萬 token · ≈ 為按 2026-11-14 各國央行參考匯率換算的新台幣參考價，實際以美元計費
07常見錯誤與排除
Cursor 之外，命令列工具的寫法見 Codex CLI 教學，用的是同一把金鑰。
401 invalid_api_key | 金鑰不對或已撤銷。到控制台重新複製一次。 |
404 model_not_found | 選單裡的 id 不在模型列表上。檢查有沒有拼錯，或把顯示名稱填到了該填 id 的地方。 |
402 insufficient_balance | 到控制台儲值，金鑰立即恢復可用。 |
| Save 或 Verify 失敗 | 最常見的原因是 Base URL 漏了 /v1。在同一台電腦上執行前面的 curl 確認。 |
常見問題
- Cursor 的 Base URL 要不要加 /v1？
- 要。Override OpenAI Base URL 填 https://api.relayswitch.io/v1，Cursor 會在後面接上 /chat/completions。Verify 失敗最常見的原因就是漏了 /v1。
- Cursor 可以用自己的 API Key 呼叫 Claude 嗎？
- 可以。Cursor 送出 OpenAI 格式的請求，目錄裡的對話模型都回應這種格式，所以在 Models 底下加入 Claude 的模型 id 就能選用，GPT、Gemini、DeepSeek 也一樣。
- Agent 模式能用嗎？
- 能，Agent 與 Ask 兩種模式都可以用。Agent 模式對 GPT 模型送出的是 Responses 格式的請求內容，閘道會當成 Chat Completions 請求解讀並回覆，價格不變。
- 用自己的 API Key，Cursor 還會另外收費嗎？
- 依 Cursor 的 API key 文件，Teams 與 Enterprise 方案會把自帶金鑰的請求計入它的用量，並加收它自己的每 token 費用，這筆由 Cursor 收取；個人方案不計入。模型本身的費用，則從你在 RelaySwitch 的預付餘額按 token 扣款。
- 怎麼開啟或關閉串流輸出？
- Cursor 預設使用串流輸出，沒有開關。所有模型都支援串流。
- 在 Cursor 裡用哪個模型比較省？
- Agent 的請求大部分是輸入 token，所以輸入單價低的模型每次請求花得最少。各模型的輸入、快取輸入與輸出價格，列在模型列表與各模型頁。