Dùng Cursor với API LLM miễn phí
Cursor có thể gửi yêu cầu chat đến khóa API OpenAI của riêng bạn. Hướng dẫn này chỉ cách kết nối khóa đó với mô hình miễn phí qua FreeLLMAPI. Hướng dẫn cũng nêu các giới hạn. Cursor định tuyến mỗi yêu cầu qua máy chủ của chính Cursor, và Tab hoàn thành luôn dùng mô hình của Cursor.
Mã, tên mô hình và nhãn danh mục trực tiếp được hiển thị bằng tiếng Anh.
Những gì hoạt động và những gì không hoạt động
Đọc phần này trước khi bắt đầu. Cursor hỗ trợ khóa riêng hẹp hơn hầu hết các trình soạn thảo khác.
| Tính năng của Cursor | Với khóa riêng của bạn | Nguồn |
|---|---|---|
| Chat với mô hình theo kiểu OpenAI tiêu chuẩn | Có. Cursor ghi trong tài liệu rằng khóa OpenAI riêng dùng được cho mô hình chat tiêu chuẩn, không suy luận. | Trang trợ giúp về khóa API của Cursor |
| Tab hoàn thành | Không. Cursor cho biết Tab tiếp tục dùng các mô hình tích hợp sẵn của Cursor. | Trang trợ giúp về khóa API của Cursor |
| Chế độ agent và Composer | Chưa được xác nhận. Tài liệu của Cursor chỉ nêu mô hình chat. Hãy thử trên gói của bạn trước khi phụ thuộc vào nó. | Chưa có tài liệu |
| Yêu cầu từ localhost | Không. Cursor gửi mọi yêu cầu qua máy chủ của họ để xây dựng prompt, nên localhost trên máy tính của bạn không nằm trên đường đi. | Trang trợ giúp về khóa API của Cursor |
Gói cũng quan trọng. Trang giá của Cursor liệt kê mô hình bên thứ ba và khóa API riêng trên các gói Premium, Super và Ultra. Trang nói rằng gói Plus không có khóa API riêng. Với gói Free, trang ghi mô hình bên thứ ba là không khả dụng. Hãy kiểm tra trang giá cho gói của bạn trước khi tiếp tục.
localhost. Đọc Cline, Roo Code và Kilo Code với API miễn phí.Bước 1: Cài FreeLLMAPI và cho phép truy cập
FreeLLMAPI là mã nguồn mở và chạy trên máy tính của bạn bằng Docker. Cài đặt nó, sau đó thêm ít nhất hai khóa nhà cung cấp miễn phí ở trang Keys.
Cài đặt trên macOS hoặc Linux
curl -fsSL https://freellmapi.co/install.sh | bashSao chép khóa thống nhất của bạn từ trang Keys. Sau đó cấp cho gateway một địa chỉ HTTPS công khai, vì máy chủ của Cursor không thể truy cập localhost của bạn. Dùng một đường hầm HTTPS đáng tin cậy hoặc một máy chủ do bạn kiểm soát. Hướng dẫn FreeLLMAPI cho Cursor in ra các bước này:
In hướng dẫn Cursor
npx freellmapi setup-cursorLệnh này không ghi tệp nào. Cursor không có tệp cấu hình cho thiết lập này, nên bạn nhập các giá trị trong cài đặt của Cursor.
Authorization, hãy tạo một token URL có thể thu hồi riêng ở mục Keys, Agents. Thu hồi nó khi bạn ngừng dùng.Bước 2: Đặt khóa và base URL trong Cursor
- Mở Cursor Settings.
- Mở Models.
- Tìm ô khóa OpenAI API. Dán khóa thống nhất FreeLLMAPI của bạn. Nhấn Save.
- Bật tùy chọn ghi đè OpenAI base URL. Hướng dẫn FreeLLMAPI gọi cài đặt này là Override OpenAI Base URL.
- Nhập địa chỉ công khai của bạn với
/v1ở cuối, ví dụhttps://<your-tunnel-host>/v1. - Chọn một mô hình trong bộ chọn mô hình và gửi một tin nhắn chat ngắn.
Tài liệu quyền riêng tư của Cursor có nhắc đến tùy chọn ghi đè base URL tương thích OpenAI. Cursor không ghi tài liệu các bước chính xác. Nhãn trong phiên bản của bạn có thể khác.
Để chắc chắn yêu cầu đến được gateway, hãy mở nhật ký yêu cầu trên bảng điều khiển. Mỗi phản hồi cũng có header X-Routed-Via cho biết nhà cung cấp và mô hình đã trả lời.
Bước 3: Chọn mô hình
Dùng mã mô hình auto để bộ định tuyến chọn một mô hình miễn phí cho mỗi yêu cầu. Bạn cũng có thể dùng mã danh mục từ GET /v1/models. Chat của Cursor gửi ngữ cảnh tệp kèm mỗi tin nhắn, nên hãy dùng mô hình có cửa sổ ngữ cảnh lớn. Bảng cho thấy các mô hình miễn phí có gọi công cụ và ít nhất 128K ngữ cảnh hiện nay.
| Mô hình | Miễn phí trên | Ngữ cảnh | Giới hạn miễn phí (ưu đãi tốt nhất) | Công cụ | Thị giác |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 yêu cầu/phút 1 req/min per model | Có | Không |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 yêu cầu/phút 40 RPM | Có | Có |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Có | Có |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Có | Không |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 yêu cầu/phút 50 yêu cầu/ngày 50 req/day account-wide (1,000 after a $10 purchase) | Có | Có |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 yêu cầu/phút 50 yêu cầu/ngày Shared rate limit | Có | Không |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 yêu cầu/phút 250 yêu cầu/ngày 70,000 token/phút ~6M | Có | Có |
Đang hiển thị 10 trong số 109 mô hình miễn phí phù hợp. Xem tất cả mô hình.
Dữ liệu trực tiếp từ danh mục FreeLLMAPI (phiên bản 2026.11.19, đã kiểm tra 2026-11-19). Giới hạn miễn phí thay đổi thường xuyên. Danh mục được kiểm tra mỗi ngày.
Cursor ghi trong tài liệu rằng khóa OpenAI riêng dùng cho mô hình chat không suy luận. Mô hình suy luận có thể lỗi qua tùy chọn ghi đè. Nếu một mô hình lỗi, hãy dùng auto hoặc một mô hình khác trong bảng.
Giới hạn tốc độ và chuyển dự phòng
Mỗi gói miễn phí có giới hạn theo phút và theo ngày. FreeLLMAPI đếm mức sử dụng của từng khóa. Khi một nhà cung cấp gửi lỗi 429, bộ định tuyến gửi yêu cầu đến mô hình tiếp theo trong chuỗi dự phòng của bạn. Cuộc chat tiếp tục và bạn không cần đổi cài đặt trong Cursor.
- Thêm khóa từ bốn nhà cung cấp trở lên. Nhiều nhà cung cấp hơn cho nhiều yêu cầu mỗi ngày hơn.
- Dùng
auto:fastcho câu hỏi ngắn vàauto:smartcho câu hỏi code khó. - Bắt đầu một cuộc chat mới cho mỗi tác vụ. Lịch sử ngắn hơn gửi ít token hơn.
Xử lý sự cố
| Vấn đề | Nguyên nhân | Cách khắc phục |
|---|---|---|
Cursor không kết nối được http://localhost:3001/v1 | Cursor gửi yêu cầu từ máy chủ của họ, không phải từ máy tính của bạn | Dùng địa chỉ HTTPS công khai cho gateway |
| Không có tùy chọn cho khóa riêng | Gói Cursor của bạn không bao gồm khóa API riêng | Kiểm tra bảng gói trên trang giá của Cursor |
401 "Invalid API key" | Khóa trong Cursor không phải là khóa thống nhất FreeLLMAPI của bạn | Sao chép lại khóa thống nhất từ trang Keys |
| Tab hoàn thành không dùng gateway | Cursor luôn dùng mô hình riêng của họ cho Tab | Không có cách khắc phục. Dùng Continue trong VS Code để tự động hoàn thành miễn phí |
| "Tất cả mô hình bị giới hạn tốc độ sau N lần thử" | Mọi khóa trong chuỗi đều đạt giới hạn | Thêm khóa từ nhiều nhà cung cấp hơn, hoặc chờ hết thời gian nghỉ |
| Mô hình tích hợp sẵn ngừng hoạt động | Tùy chọn ghi đè base URL vẫn đang bật | Tắt tùy chọn ghi đè |
Câu hỏi thường gặp
Tôi có thể dùng Cursor miễn phí với khóa API riêng không?
Trang giá của Cursor liệt kê khóa API riêng trên các gói Premium, Super và Ultra, và nói rằng gói Plus không có khóa riêng. Trên gói có khóa riêng, FreeLLMAPI cung cấp mô hình miễn phí cho chat, nên chi phí suy luận là $0.
Vì sao Cursor không kết nối được localhost?
Cursor gửi mọi yêu cầu qua máy chủ của họ để xây dựng prompt. Các máy chủ đó không thể truy cập localhost trên máy tính của bạn, nên gateway cần một địa chỉ HTTPS công khai.
Tính năng tự động hoàn thành Tab của Cursor có hoạt động với API tùy chỉnh không?
Không. Tài liệu của Cursor nói rằng khóa API tùy chỉnh chỉ hoạt động với mô hình chat, và Tab hoàn thành tiếp tục dùng mô hình tích hợp sẵn của Cursor.
Mô hình miễn phí nào tốt nhất cho Cursor?
Dùng auto, hoặc một mô hình có gọi công cụ và ít nhất 128K ngữ cảnh trong bảng trên trang này. Cursor gửi ngữ cảnh tệp kèm mỗi tin nhắn, nên cửa sổ ngữ cảnh lớn rất quan trọng.
Code của tôi có được gửi đến Cursor khi tôi dùng khóa riêng không?
Có. Cursor cho biết các yêu cầu đi qua máy chủ của họ để xây dựng prompt cuối cùng. Zero Data Retention không áp dụng khi bạn dùng khóa riêng.
Hướng dẫn liên quan
- Mô hình AI miễn phí trong VS Code
- Cline, Roo Code và Kilo Code với API miễn phí
- Continue với API LLM miễn phí
- API model lập trình miễn phí tốt nhất
- Base URL API tương thích OpenAI miễn phí
Nguồn
- Cursor help: API keys (đã kiểm tra 20 November 2026)
- Cursor docs: models and pricing (đã kiểm tra 20 November 2026)
- Cursor docs: privacy and data governance (đã kiểm tra 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (đã kiểm tra 20 November 2026)
- FreeLLMAPI CLI generators (đã kiểm tra 20 November 2026)