Cấu hình Cursor với API key và Base URL tùy chỉnh
Dán key RelaySwitch vào ô OpenAI API Key của Cursor, bật Override OpenAI Base URL và điền https://api.relayswitch.io/v1, rồi thêm id model: mọi model chat trên key đều chọn được trong Cursor. Agent mode và Ask mode đều chạy.
01Vì sao một key dùng được cho mọi model trong Cursor
Cursor gửi request theo định dạng OpenAI, và mọi model chat trong danh sách model đều trả lời định dạng đó. Vì vậy một key phủ được Claude, GPT, Gemini và DeepSeek trong cùng một ô chọn model, mỗi model tính theo giá token của nó và trừ vào số dư trả trước.
Bạn không đổi gì ở cách dùng Cursor. Thứ thay đổi là nơi request được gửi tới và bên tính tiền cho các request mang key của bạn.
02Điền ba ô trong Cursor Settings
- Mở Cursor Settings (
Cmd/Ctrl + ,), vào mục Models. Ô key và ô Base URL nằm dưới danh sách model. - Bật OpenAI API Key và dán toàn bộ key lấy từ console.
- Bật Override OpenAI Base URL và điền https://api.relayswitch.io/v1, có
/v1ở cuối. - Bấm Save. Các bản Cursor cũ gọi nút này là Verify.
- Trong mục Models, thêm từng id bạn muốn dùng, viết đúng như trang danh sách model ghi; id của Claude cũng thêm được. Sau đó chọn một id trong khung chat.
OpenAI API Key: sk-relay-...Override OpenAI Base URL: https://api.relayswitch.io/v1Models: gpt-6.1-sol03Mỗi ô làm gì
| OpenAI API Key | Thông tin xác thực mà Cursor gửi kèm mỗi request. Dán toàn bộ key từ console, không chỉ phần đầu. |
| Override OpenAI Base URL | Đưa các request đó tới https://api.relayswitch.io/v1 thay vì tới OpenAI. |
| Models | Danh sách mà ô chọn model đưa ra. Thêm từng id muốn dùng, viết đúng id chứ không phải tên hiển thị. |
04Kiểm tra bằng curl rồi thử trong Cursor
Gửi một request theo đúng kiểu Cursor gửi, từ chính máy đang chạy Cursor. Nhận về câu trả lời là key và Base URL đều đúng. Sau đó, trong Cursor, chọn một id của bạn và gửi một tin nhắn: request hiện trong trang Usage của console kèm số token và số tiền.
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"}]}'05Chọn model nào cho Cursor
Request ở Agent mode mang theo hội thoại, các file Cursor đã đọc và kết quả của tool, nên token input chiếm phần lớn hóa đơn. Model có giá input thấp thì mỗi request tốn ít nhất. Bảng dưới là giá các model chủ lực, USD cho mỗi triệu token, đọc trực tiếp từ catalog; trang riêng của từng model ghi đủ giá input, cached input và output.
Khi response báo có token input đọc từ cache, phần đó được tính theo giá cached của model thay vì giá input. Một cuộc chat dài lặp lại cùng phần mở đầu vì thế tốn ít hơn ở mỗi lượt so với một cuộc chat mới. Cách tính chi tiết ở trang bảng giá.
| Model | Nhà phát triển | Input | Output | Context |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| DeepSeek V4.1 Flash 1017deepseek-v4.1-flash-1017 | DeepSeek | $0.2425 | $1.164 | 1,048,576 |
| GLM 5.3 Flashglm-5.3-flash | Z.ai | $0.0873 | $0.1455 | 1,000,000 |
| GPT-6 Lunagpt-6-luna | OpenAI | $0.0625 | $0.20 | 1,050,000 |
| Qwen3.8 Maxqwen3.8-max | Qwen | $0.80 | $2.40 | 991,000 |
| Minimax M3.1 Flashminimax-m3.1-flash | MiniMax | $0.105 | $0.42 | 1,000,000 |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925 | $2.25 | 1,048,576 | |
| Grok 4.7grok-4.7 | xAI | $0.60 | $1.80 | 500,000 |
| Kimi K3kimi-k3 | Moonshot AI | $0.90 | $4.50 | 1,048,576 |
USD cho mỗi triệu token
06Agent mode và các model GPT
Khi bật ghi đè Base URL, Agent mode của Cursor gửi cho các model GPT một request body kiểu Responses API nhưng tới đường dẫn của Chat Completions. Cursor ghi nhận đây là một lỗi đã biết trên diễn đàn của họ.
Gateway đọc body đó như request Chat Completions mà nó đại diện và trả lời theo định dạng Chat Completions, có streaming hay không cũng vậy. Các id GPT chạy được ở cả Agent mode lẫn Ask mode, với cùng mức giá.
07Tính tiền và lỗi thường gặp
Request tính theo token theo giá của model, trừ vào số dư trả trước. Riêng với gói Teams và Enterprise của Cursor: Cursor tính các request dùng key riêng vào mức sử dụng của gói và thu thêm một khoản phí theo token của họ; khoản đó do Cursor thu, không phải ở đây. Các gói cá nhân thì không bị tính (theo tài liệu về API key của Cursor).
401 invalid_api_key | Key sai hoặc đã bị thu hồi. Chép lại key từ console. |
402 insufficient_balance | Hết số dư. Nạp thêm trong console là key chạy lại ngay; xem trang nạp tiền. |
404 model_not_found | Id trong ô chọn model không có trong danh sách model. Kiểm tra lỗi gõ, hoặc tên hiển thị bị điền vào chỗ của id. |
| Bước Verify thất bại | Thường là Base URL thiếu /v1, hoặc một proxy trên máy chặn request. Chạy lệnh curl ở trên từ cùng máy đó để biết lỗi nằm ở đâu. |
Câu hỏi thường gặp
- Base URL trong Cursor có cần /v1 không?
- Có. Ô Override OpenAI Base URL điền https://api.relayswitch.io/v1; Cursor tự ghép /chat/completions vào sau. Nguyên nhân hay gặp nhất khiến bước Verify thất bại là thiếu /v1.
- Dùng được model Claude trong Cursor bằng key này không?
- Được. Mọi model chat trong catalog đều trả lời định dạng OpenAI mà Cursor gửi, nên id của Claude, GPT, Gemini hay DeepSeek đều thêm được vào mục Models và chọn trong khung chat.
- Cursor có cần bật streaming không?
- Không cần. Cursor mặc định dùng streaming và không có nút bật tắt. Mọi model ở đây đều hỗ trợ streaming.
- Dùng API key riêng thì Cursor có thu thêm phí không?
- Với gói Teams và Enterprise, Cursor tính request dùng key riêng vào mức sử dụng của gói và thu thêm phí theo token của họ; khoản đó do Cursor thu. Các gói cá nhân không bị tính, theo tài liệu về API key của Cursor. Phần token của model thì trừ vào số dư trả trước ở RelaySwitch.
- Agent mode có chạy được với model GPT không?
- Có. Agent mode gửi cho model GPT một body kiểu Responses tới đường dẫn Chat Completions; gateway đọc được body đó và trả lời theo định dạng Chat Completions, giá không đổi.
- Lấy API key cho Cursor ở đâu và trả tiền thế nào?
- Mở tài khoản tại app.relayswitch.io bằng email, nạp từ $10 bằng thẻ (kể cả Apple Pay, Google Pay) hoặc crypto (USDT, USDC, BTC, ETH, SOL), rồi tạo key. Số dư tính bằng USD, không hết hạn, không thuê bao; khoản nạp không được hoàn lại.
Mọi model trong ô chọn của Cursor
Một key, số dư trả trước, nạp bằng thẻ hoặc crypto.