Trang chủ / Hướng dẫn / Dùng Cursor với API LLM miễn phí

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 CursorVới khóa riêng của bạnNguồn
Chat với mô hình theo kiểu OpenAI tiêu chuẩnCó. 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ànhKhô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à ComposerChư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ừ localhostKhô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.

Lưu ý: nếu bạn muốn một agent miễn phí trong trình soạn thảo, không phụ thuộc quy định của gói, hãy dùng Cline, Roo Code hoặc Kilo Code trong VS Code. Các công cụ này kết nối trực tiếp đến 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 | bash

Sao 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-cursor

Lệ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.

Bảo mật: URL công khai cho phép bất kỳ ai có khóa thống nhất của bạn dùng hạn mức miễn phí của bạn. Không bao giờ chia sẻ khóa. Nếu đường hầm của bạn không gửi được header 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

  1. Mở Cursor Settings.
  2. Mở Models.
  3. Tìm ô khóa OpenAI API. Dán khóa thống nhất FreeLLMAPI của bạn. Nhấn Save.
  4. 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.
  5. Nhập địa chỉ công khai của bạn với /v1 ở cuối, ví dụ https://<your-tunnel-host>/v1.
  6. 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.

Quan trọng: khi bật, ghi đè có hiệu lực toàn cục. Hãy tắt nó trước khi chuyển lại sang nhà cung cấp tích hợp sẵn của Cursor.

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í cho chat Cursor: gọi công cụ và ngữ cảnh 128K trở lên
Mô hìnhMiễn phí trênNgữ cảnhGiới hạn miễn phí (ưu đãi tốt nhất)Công cụThị giác
GLM 5.3UnoRouter1M1 yêu cầu/phút
1 req/min per model
CóKhông
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 yêu cầu/phút
40 RPM
CóCó
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaCóCó
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceCóKhông
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditCóCó
Gemini 3.7 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditCóCó
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 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 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 yêu cầu/phút
50 yêu cầu/ngày
Shared rate limit
CóKhông
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 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:fast cho câu hỏi ngắn và auto:smart cho 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ânCách khắc phục
Cursor không kết nối được http://localhost:3001/v1Cursor 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ạnDùng địa chỉ HTTPS công khai cho gateway
Không có tùy chọn cho khóa riêngGói Cursor của bạn không bao gồm khóa API riêngKiể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ạnSao chép lại khóa thống nhất từ trang Keys
Tab hoàn thành không dùng gatewayCursor luôn dùng mô hình riêng của họ cho TabKhô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ạnThê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 độngTùy chọn ghi đè base URL vẫn đang bậtTắt tùy chọn ghi đè
Dùng tất cả các mô hình này qua một khóa duy nhất. FreeLLMAPI là bộ định tuyến mã nguồn mở, tự lưu trữ. Nó đặt tất cả các gói miễn phí này sau một endpoint duy nhất tương thích OpenAI, và tự chuyển sang nhà cung cấp khác khi một nhà cung cấp bị giới hạn tốc độ. Xem danh mục hoặc bắt đầu.

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

Nguồn

Tất cả hướng dẫn · Xem tất cả mô hình miễn phí