Để cấu hình Cursor với API tương thích OpenAI, bạn chọn OpenAI Compatible, nhập API key và base URL của nhà cung cấp, chọn model ID rồi bấm Verify. Tên và vị trí các mục có thể khác theo phiên bản Cursor. Bài này đi từ những thông tin bạn cần chuẩn bị đến thao tác trong Cursor, rồi thử một câu hỏi ngắn ở Chat để biết kết nối có hoạt động hay không. Bạn cũng sẽ biết cần kiểm tra gì khi Verify báo lỗi hoặc model vừa thêm chưa xuất hiện. Đừng lấy việc Tab completion vẫn chạy làm bằng chứng rằng key mới đã được dùng: tính năng đó có thể tiếp tục dùng model tích hợp của Cursor. Khi chụp màn hình để nhờ hỗ trợ, hãy che API key trước khi gửi.
Tóm tắt nhanh
- Cần 3 thông tin trước khi mở phần cài đặt: API key, base URL và model ID.
- Lấy model ID từ danh sách model do API trả về; nhập đúng ID thay vì đoán theo tên hiển thị.
- Sau khi bấm Verify, thử một câu hỏi trong Cursor Chat; nếu chưa thấy model, kiểm tra lại danh sách hiển thị.
Cursor, API key, base URL và model ID giữ vai trò gì?
Bạn có thể nhập đúng API key mà Cursor vẫn không gọi được model mong muốn: key chỉ chứng minh quyền truy cập, không cho Cursor biết phải gửi yêu cầu đến máy chủ nào hoặc gọi model nào. Bốn thành phần trong màn hình cấu hình giải quyết bốn việc khác nhau.
Cursor gửi yêu cầu đi đâu?
Cursor là ứng dụng bạn dùng để mở dự án, đọc mã và hỏi trợ lý trong Chat. Khi chọn OpenAI Compatible, bạn đang chỉ cho Cursor cách gửi yêu cầu theo giao diện API tương thích OpenAI; lựa chọn này không có nghĩa yêu cầu
sẽ tự động đi tới máy chủ
của OpenAI. Chẳng hạn, câu hỏi “Hàm `calculateTotal()` xử lý phí giao hàng ở đâu?” được nhập trong Cursor, còn nơi nhận yêu cầu phụ thuộc vào base URL bạn cấu hình. Base URL là địa chỉ gốc của dịch vụ nhận yêu cầu. Nếu dịch vụ cung cấp địa chỉ kết thúc bằng `/v1`, bạn cần nhập đúng địa chỉ đó theo hướng dẫn của dịch vụ; chỉ đổi key mà giữ base URL của nhà cung cấp khác vẫn có thể gửi yêu cầu sai nơi. Base URL không phải trang dashboard để lấy key, cũng không phải đường dẫn tới tệp mã trong dự án.
Ai được gọi, và gọi model nào?
API key là thông tin xác thực đi kèm yêu cầu gửi tới dịch vụ. Cursor dùng key để dịch vụ kiểm tra quyền truy cập, vì vậy đừng đưa key thật vào ảnh chụp màn hình hoặc đoạn mã chia sẻ trong nhóm. Một key hợp lệ cũng chưa đủ để bảo đảm mọi model trong danh sách đều dùng được với tài khoản
của bạn. Model ID là giá trị chỉ định model trong trường `model` của yêu cầu, không phải tên gọi bạn tự đặt cho dễ nhớ. Ví dụ, nếu danh sách API trả về ID `claude-sonnet-5`, hãy dùng đúng chuỗi đó thay vì gõ “Claude Sonnet”. Sau khi chọn model trong Cursor, nút Verify kiểm tra cấu hình; việc model có xuất hiện trong danh sách của Cursor hay không còn có thể phụ thuộc vào danh sách đã được ứng dụng lưu trước đó. Vị trí các mục và hành vi xác minh cần đối chiếu với phiên bản Cursor bạn đang dùng.
Cần chuẩn bị gì trước khi kết nối Cursor?
| Ứng dụng | Mô tả | Đối tượng | Ghi chú |
|---|---|---|---|
| Trước khi mở phần cấu hình, hãy ghi lại phiên bản Cursor bạn đang dùng. Tên mục và vị trí chọn OpenAI Compatible có thể thay đổi giữa các phiên bản; ảnh hướng dẫn chỉ đáng đối chiếu khi bạn biết mình đang nhìn đúng màn hình cấu hình model. Bạn có thể kiểm tra phiên bản trong mục About Cursor, rồi tìm phần cài đặt model và xem có tùy chọn OpenAI Compatible hay không. Nếu không thấy, đừng đoán rằng trường nhập key của một nhà cung cấp khác có cùng tác dụng. | Thành phần | Nơi lấy hoặc kiểm tra | Mục đích sử dụng |
| Phiên bản Cursor | Mục About Cursor trong ứng dụng | Đối chiếu tên mục trên giao diện với hướng dẫn | |
| API key | Dashboard của dịch vụ cấp API | Xác thực yêu cầu gửi từ Cursor Chat | |
| Base URL | Tài liệu API của dịch vụ bạn dùng | Xác định địa chỉ mà Cursor gửi yêu cầu | |
| Model ID | Danh sách model do dịch vụ trả về | Chọn đúng model có thể gọi qua key đó | |
| Câu hỏi thử | Tự viết một câu về đoạn mã ngắn | Kiểm tra Chat có nhận phản hồi sau khi thiết lập |
Kiểm tra thông tin trước khi nhập Đặt API key ở nơi bạn có thể dán trực tiếp vào Cursor, nhưng không đưa key vào ảnh chụp màn hình hay tin nhắn trao đổi trong nhóm. Với base URL, giữ đúng phần đường dẫn mà dịch vụ yêu cầu; đừng tự nối thêm `/chat/completions` vào ô nhập nếu tài liệu hướng dẫn điền URL gốc. Model ID cũng cần khớp từng ký tự với danh sách trả về, thay vì tên gọi rút gọn bạn nhớ từ một bài viết. Chuẩn bị sẵn một câu ngắn như: “Hàm JavaScript `const double = n => n * 2` trả về gì khi `n = 3`?” Sau khi chọn model, bạn
sẽ dùng câu này trong Cursor Chat và xem model nào đang được chọn lúc nhận phản hồi. Trước khi thử, bấm Verify: Cursor có thể lưu danh sách model trong cache, nên model vừa được cấp quyền chưa chắc xuất hiện ngay. Việc Chat trả lời cũng không phải phép thử cho Tab completion; hai chế độ này cần được đánh giá riêng.
Cấu hình Cursor với API tương thích OpenAI theo từng bước
Điểm dễ sai nhất là chọn một model theo tên quen thuộc nhưng chưa kiểm tra ID mà dịch vụ thực sự cung cấp. Bạn nên giữ nguyên ID trả về từ `GET /v1/chat/models`, kể cả dấu gạch nối và số phiên bản. Quy trình dưới đây tách thao tác trong Cursor khỏi thao tác lấy danh sách model để bạn biết mình đang kiểm tra ở đâu.
Thao tác và đối chiếu trên màn hình
| Bước | Thao tác | Ảnh cần chụp khi biên soạn |
|---|---|---|
| 1 | Mở dashboard của dịch vụ API, lấy API key và giữ ở nơi riêng. Chưa dán key vào ghi chú hay ảnh chụp màn hình. | Vị trí lấy key trên dashboard, không hiển thị giá trị key. |
| 2 | Mở phần cài đặt model trong Cursor và tìm OpenAI Compatible. Kiểm tra tên mục trên chính phiên bản bạn đang dùng trước khi bấm, vì giao diện có thể khác. | Màn hình chứa tùy chọn tương ứng và phiên bản Cursor nếu giao diện hiển thị. |
| 3 | Dán key vào trường API key; nhập base URL do dịch vụ cung cấp vào trường URL. Kiểm tra URL trỏ tới gốc `/v1`, không dán đường dẫn `/chat/completions` vào trường base URL. | Hai trường cấu hình sau khi đã che toàn bộ key. |
| 4 | Lấy danh sách model bằng `GET /v1/chat/models` với header `x-api-key: YOUR_API_KEY`; đọc trường ID trong kết quả thực tế. Nếu không tự gọi API, dùng màn hình danh sách model mà dịch vụ cung cấp và đối chiếu ID tại đó. | Một ID có trong kết quả, không kèm header xác thực. |
| 5 | Quay lại Cursor, chọn hoặc nhập đúng ID vừa lấy ở bước 4. Đừng thay ID bằng tên hiển thị do bạn tự đặt. | Model ID đang được chọn trong Cursor. |
| 6 | Bấm Verify nếu phiên bản Cursor của bạn có nút này, rồi đọc thông báo trả về. Nếu danh sách chưa cập nhật, kiểm tra lại ID và thực hiện Verify trước khi kết luận model không có. | Thông báo xác nhận hoặc lỗi, đã che thông tin nhạy cảm. |
| 7 | Mở Cursor Chat, chọn model vừa xác nhận và hỏi: `Hàm này xử lý trường hợp input rỗng thế nào?` trên một đoạn mã bạn có quyền sử dụng. Kiểm tra model hiển thị cạnh cuộc trò chuyện. | Câu hỏi, phản hồi và model đang dùng; che mã nguồn riêng tư nếu cần. |
Khi biên soạn bài có ảnh thực tế, đặt ảnh tương ứng ngay sau nội dung của từng bước. Kết quả ở bước 7 chỉ xác nhận luồng Chat bạn vừa thử; nó không chứng minh mọi chế độ trong Cursor đều dùng cùng API key.
Vì sao Verify thất bại hoặc model chưa xuất hiện?
Model không có trong danh sách Cursor có thể giữ danh sách model cũ trong cache, nên việc một model chưa xuất hiện không đủ để kết luận tài khoản
của bạn không dùng được model đó. Bấm Verify
sau khi cấu hình, rồi kiểm tra lại danh sách trong giao diện hiện tại. Nếu vẫn không thấy, đối chiếu model ID trong Cursor với ID trả về từ `GET /v1/chat/models`; so từng ký tự, kể cả dấu gạch nối và số phiên bản. Đừng lấy tên hiển thị của model thay cho ID.
Verify báo lỗi Kiểm tra hai thứ trước: key còn quyền truy cập hay không và base URL có
được nhập đúng vào trường dành cho máy chủ API hay không. Nếu Cursor chỉ báo lỗi chung, đừng đoán rằng nguyên nhân chắc chắn là model: key sai, quyền truy cập thiếu hoặc URL nhập nhầm đều cần được loại trừ. Tên trường cấu hình và cách Cursor hiển thị lỗi có thể khác theo phiên bản; chúng tôi chưa xác nhận một thông báo lỗi áp dụng cho mọi bản. Nếu cần gửi ảnh màn hình hoặc nhật ký để nhờ hỗ trợ, hãy che toàn bộ API key trước khi đăng. Kiểm tra cả phần URL, header và nội dung request trong nhật ký; key có thể nằm ở `Authorization: Bearer …` hoặc `x-api-key`. Nếu đã lỡ công khai key, thu hồi key đó và tạo key mới trước khi thử lại.
Verify thành công nhưng Tab không đổi Hãy đánh giá kết nối bằng một yêu cầu trong Cursor Chat, không dùng gợi ý Tab completion làm phép thử. Tài liệu Cursor
được dẫn trong nguồn tham khảo cho biết API key riêng áp dụng cho chat models, còn Tab completion dùng model tích hợp
của Cursor. Vì vậy, Tab vẫn hoạt động như cũ không chứng minh cấu hình Chat thất bại; khi báo lỗi, hãy ghi rõ bạn đang thử Chat hay Tab và phiên bản Cursor đang dùng.
Hai tình huống dùng Cursor Chat tại Việt Nam
Hai ví dụ dưới đây giả định bạn đã chọn OpenAI Compatible, nhập key và base URL, chọn model ID từ danh sách API rồi bấm Verify. Giao diện chọn model có thể khác theo phiên bản Cursor; hãy đối chiếu màn hình bạn đang dùng. Đây là cách đặt câu hỏi để thử Chat trong công việc, không phải kết quả đo hiệu năng.
Một lập trình viên đọc hàm tính phí giao hàng Bạn đang sửa một dự án bán hàng và gặp hàm `calculateShippingFee(order)` có nhiều nhánh theo tỉnh, trọng lượng và mã giảm giá. Chọn đúng hàm trong editor, mở Cursor Chat rồi hỏi: “Giải thích thứ tự áp dụng mã giảm giá và phụ phí trong hàm này. Chỉ ra nhánh nào trả về sớm, kèm dòng mã làm căn cứ.” Tên hàm và ngữ cảnh ở đây chỉ là ví dụ minh họa; bạn thay bằng hàm thật trong dự án
của mình. Đọc câu trả lời cùng mã nguồn đang mở, nhất là nhánh `return` và điều kiện tính phí. Nếu Chat nói phí được cộng trước khi giảm giá, hãy đối chiếu thứ tự các phép tính thay vì sửa mã ngay. Ghi lại phiên bản Cursor trong mục About, model ID đang chọn và tên model hiển thị bên cạnh phản hồi nếu giao diện có hiển thị. Hai tên này không nhất thiết giống nhau; đừng tự suy ra model đã trả lời chỉ từ cấu hình bạn vừa lưu.
Nhóm phát triển lần theo một đoạn mã khó Một nhóm làm phần mềm quản lý đơn hàng thấy đoạn xử lý trạng thái trải qua `validateOrder`, `reserveStock` rồi `createShipment`. Người phụ trách chọn đoạn mã liên quan trong Cursor Chat và hỏi: “Vẽ luồng gọi giữa ba hàm bằng danh sách có thứ tự; với mỗi bước, nêu điều kiện chuyển tiếp và nơi phát sinh lỗi. Nếu thiếu mã
của hàm được gọi, ghi rõ chưa đủ dữ liệu.” Đây là yêu cầu gợi ý cách đọc mã, không phải nhờ Chat kết luận toàn bộ luồng nghiệp vụ. Khi trao đổi trong nhóm, gửi kèm đoạn mã đã loại bỏ dữ liệu nhạy cảm, câu hỏi đã dùng, phiên bản Cursor và model ID ghi nhận lúc Chat trả lời. Nếu một thành viên thử lại bằng phiên bản Cursor khác, họ có thể kiểm tra xem Chat đã nhận cùng đoạn mã được chọn hay chưa trước khi so nội dung phản hồi. Chưa có phép đo nào ở hai tình huống này để kết luận model nào trả lời tốt hơn.
Kiểm tra lời gọi RevidAPI khi cần khoanh vùng lỗi
Nếu Cursor báo lỗi ở bước Verify, hãy thử gọi riêng `POST https://revidapi.com/v1/chat/completions` bằng cùng API key và model ID. Phép thử này kiểm tra đường gọi Chat có hoạt động ngoài Cursor hay không; nó không xác nhận mọi chế độ trong Cursor đều dùng được key riêng.
Chuẩn bị yêu cầu thử Lấy model ID thực tế từ `GET https://revidapi.com/v1/chat/models`, rồi chuẩn bị `request.json` theo tài liệu API trên dashboard. Trong tệp, dùng đúng ID vừa lấy cho trường `model` và một yêu cầu Chat ngắn cho `messages`; đừng tự đặt tên model theo nhãn hiển thị trong Cursor. Dùng cùng key đang nhập trong Cursor, nhưng không dán key vào tệp JSON hoặc ảnh chụp màn hình. Sau khi đặt key vào biến môi trường `REVIDAPI_KEY` và chuẩn bị xong `request.json`, chạy lệnh:
curl 'https://revidapi.com/v1/chat/completions' \ -H "Authorization: Bearer $REVIDAPI_KEY" \ -H 'Content-Type: application/json' \ --data-binary @request.json
curl 'https://revidapi.com/v1/chat/completions' \ -H "Authorization: Bearer $REVIDAPI_KEY" \ -H 'Content-Type: application/json' \ --data-binary @request.jsonĐọc kết quả để xác định chỗ cần kiểm tra Nếu lệnh trả về phản hồi Chat nhưng Cursor vẫn không thấy model, hãy đối chiếu model ID trong giao diện với ID từ `GET /v1/chat/models`, rồi bấm Verify lại; danh sách model trong Cursor có thể đang
được lưu trong cache. Kiểm tra trên đúng phiên bản Cursor bạn đang dùng, vì vị trí và hành vi
của tùy chọn cấu hình có thể thay đổi. Nếu lệnh báo lỗi xác thực, kiểm tra giá trị `REVIDAPI_KEY` và key trên dashboard trước khi sửa cấu hình Cursor. Nếu phản hồi báo model không hợp lệ, kiểm tra lại trường `model` trong `request.json` với danh sách API; đừng đổi base URL để thử vận may. Khi lệnh chạy được mà một chế độ Cursor vẫn lỗi, hãy thử một câu trong Cursor Chat và ghi lại thông báo lỗi, phiên bản Cursor cùng chế độ đã dùng. Lời gọi `chat/completions` thành công không chứng minh Tab completion hoặc mọi chế độ khác sẽ đi qua API này.
Câu hỏi thường gặp khi cấu hình Cursor
Cấu hình Cursor với API tương thích OpenAI cần gì?
Cần API key, base URL, model ID và phiên bản Cursor có tùy chọn cấu hình phù hợp.
Base URL RevidAPI theo hướng dẫn này là gì?
Dùng `https://revidapi.com/v1`; kiểm tra phiên bản Cursor có cho nhập URL này không.
Lấy model ID ở đâu? Lấy ID từ danh sách API trả về; không tự đoán tên model.
Vì sao Cursor chưa nhận model vừa thêm?
Cursor có thể lưu danh sách model trong cache; kiểm tra ID và bấm Verify.
API key riêng có áp dụng cho Cursor Tab không? Theo tài liệu Cursor
được dẫn lại, Tab completion vẫn dùng model tích hợp của Cursor.
Khám phá workflow miễn phí tại AI Tạo ảnh & Video và lấy API key tại API Marketplace RevidAPI.
Khám phá API Marketplace RevidAPI — lấy API key miễn phí · Nhóm Zalo hỗ trợ · revidapi@gmail.com
