Hướng dẫn cấu hình Cursor IDE dùng API key apicheap.store từng bước

Cursor là trình soạn mã tích hợp AI, xây dựng trên nền VS Code. Ngoài việc dùng trực tiếp API của OpenAI hay Anthropic, Cursor cho phép trỏ sang một nhà cung cấp tương thích chuẩn OpenAI bất kỳ. Bài này hướng dẫn trỏ Cursor sang apicheap.store để bạn dùng được nhiều model AI qua một API key duy nhất.

Chuẩn bị trước khi cấu hình

Bạn cần hai thứ:

1. Tài khoản tại apicheap.store với số dư trong ví. Nạp tiền qua VietQR hoặc USDT — số dư được cộng tự động sau khi hệ thống đối soát giao dịch.
2. Một API key dạng sk-..., tạo trong mục API Keys của trang quản lý.

Nếu bạn muốn hệ thống tự chuyển sang model dự phòng khi một model gặp sự cố, hãy vào tab Bộ combo trong trang quản lý, bấm tạo combo mới, chọn các model dự phòng rồi lưu lại. Sau khi lưu xong mới điền tên combo vào cấu hình Cursor. Nếu không cần dự phòng, bạn điền thẳng tên model lẻ.

Mở cửa sổ cấu hình model trong Cursor

Cursor lưu cấu hình nhà cung cấp AI trong phần Settings riêng, không phải file settings.json của VS Code.

1. Mở Cursor, bấm biểu tượng bánh răng (Settings) ở góc trên bên phải, hoặc nhấn Ctrl + , (Windows/Linux) hay Cmd + , (macOS).
2. Trong thanh tìm kiếm của Settings, gõ Models hoặc OpenAI.
3. Tìm mục OpenAI API Key (hoặc mục tương tự tuỳ phiên bản Cursor).

Điền thông số kết nối

Cursor cần ba thông số:

• Override OpenAI Base URL: nhập https://apicheap.store/v1
• OpenAI API Key: nhập API key sk-... của bạn tại apicheap.store
• Model Name: nhập tên model lẻ hoặc tên combo bạn đã tạo

Ví dụ bạn đã tạo combo tên smart-live-combo trong trang quản lý, hãy điền tên đó vào ô Model Name. Nếu chưa tạo combo, bạn có thể điền thẳng một mã model lẻ có trong tài khoản.

Chuỗi smart-live-combo trong bài này chỉ là tên minh hoạ. Nếu tài khoản của bạn chưa tạo combo trùng tên, Cursor sẽ báo lỗi. Thay bằng tên combo bạn đã tạo hoặc mã model lẻ thật.

Kiểm tra kết nối bằng cURL trước khi dùng

Trước khi giao việc cho Cursor, nên gọi thử API để chắc chắn key và tên model đều đúng. Mở terminal và chạy:

curl https://apicheap.store/v1/models \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

Lệnh trên trả về danh sách model và combo mà key của bạn được phép gọi. Nếu thấy tên model hoặc combo bạn định dùng trong kết quả, cấu hình phía máy chủ đã sẵn sàng.

Tiếp theo, gửi một request nhỏ để kiểm tra luồng chat:

curl https://apicheap.store/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "smart-live-combo", "messages": [{"role": "user", "content": "Hello"}]}'

Nhận về câu trả lời nghĩa là đường truyền thông suốt.

Dùng Cursor hằng ngày sau khi cấu hình

Sau khi lưu xong, chọn model hoặc combo bạn vừa thêm trong khung Chat rồi hỏi về code như bình thường. Các câu trả lời lúc này đi qua apicheap.store và được trừ vào số dư của bạn.

Cần lưu ý rằng API key riêng không áp dụng cho mọi tính năng của Cursor:

• Tab (gợi ý code khi gõ) dùng model riêng của Cursor, không đi qua Base URL bạn vừa điền.
• Agent và một số tính năng chuyên biệt khác có thể cũng chạy trên hạ tầng của Cursor. Hành vi này thay đổi theo phiên bản, nên hãy thử trực tiếp trên bản bạn đang dùng.

Vì vậy nếu thấy Tab vẫn chạy khi key apicheap.store hết số dư, đó là điều bình thường: Tab không dùng key này.

Chọn model phù hợp cho từng việc

Cursor cho phép đổi model khi bắt đầu cuộc chat mới. Gợi ý chọn model theo tác vụ:

• Sửa code, viết hàm mới, review PR: dùng model mạnh có khả năng suy luận sâu.
• Giải thích đoạn code, viết comment, tóm tắt: model nhẹ hơn vẫn làm tốt và tiết kiệm số dư hơn.
• Cần ổn định, ít gián đoạn: tạo combo với nhiều model dự phòng — khi model đầu bận hoặc lỗi, hệ thống tự chuyển sang model kế tiếp mà không cần bạn can thiệp.

Giá từng model xem ở bảng giá trên trang chủ.

Xử lý lỗi thường gặp

Cursor báo lỗi 401. Key sai, đã hết hạn hoặc có thừa dấu cách khi dán. Mở lại Settings, xoá key cũ và dán lại key mới từ trang quản lý.

Cursor báo model không tồn tại (404). Tên model trong ô Model Name gõ sai, hoặc bạn dùng tên combo mẫu mà chưa tạo combo đó. Gọi GET /v1/models như hướng dẫn ở trên để lấy đúng tên.

Cursor báo lỗi 429. Gửi quá nhiều request trong thời gian ngắn. Chờ vài giây rồi gửi lại, và giảm số cuộc chat chạy song song.

Gợi ý chạy chậm hoặc bị ngắt giữa chừng. Thử đổi sang model hoặc combo khác. Nếu đang dùng model lẻ, hãy tạo combo để hệ thống tự chuyển tuyến khi model hiện tại phản hồi chậm.

Đã lưu cấu hình nhưng Cursor vẫn gọi máy chủ cũ. Kiểm tra công tắc của mục Override OpenAI Base URL đã bật chưa, rồi đóng hẳn Cursor và mở lại.

Muốn quay lại model có sẵn của Cursor. Tắt công tắc Override OpenAI Base URL. Khi công tắc còn bật, Cursor có thể gửi cả model họ OpenAI có sẵn qua địa chỉ bạn đã điền.

Cursor cùng các công cụ khác trên một API key

API key của apicheap.store không bị giới hạn một công cụ. Bạn có thể dùng cùng key đó cho Claude Code CLI, OpenAI Codex, hay thư viện Python cùng lúc. Tất cả đều trừ vào chung một số dư.

Nếu bạn dùng Claude Code CLI, xem bài kết nối Claude Code CLI với apicheap.store. Nếu dùng OpenAI Codex, xem bài cấu hình Codex CLI và Codex App. Tài liệu đầy đủ cho mọi công cụ nằm ở trang tài liệu kết nối.

Tóm tắt

Để dùng model qua apicheap.store trong Cursor, bạn mở Settings, điền Base URL là https://apicheap.store/v1, dán API key và nhập tên model hoặc combo. Chat sẽ chạy qua cổng này, còn Tab vẫn dùng model riêng của Cursor.