Cursor

Tích hợp có điều kiện: dùng đường OpenAI API key + Override OpenAI Base URL trong bản Cursor có tùy chọn này. Theo tài liệu Cursor, API key riêng hỗ trợ chat; Tab completion vẫn dùng model của Cursor. Không mặc định rằng mọi model reasoning hoặc mọi chế độ Agent đều chạy qua custom endpoint.

1. Chuẩn bị

1. Cài/cập nhật Cursor.
2. Tạo key thuộc group có model hỗ trợ OpenAI Chat Completions.
3. Lấy model ID từ Kiểm tra model. Gateway phải truy cập được qua HTTPS công khai vì request đi qua backend Cursor.

2. Điền key và endpoint

Mở Cursor Settings → Models (một số phiên bản ghi Models & API Keys):

1. Trong phần OpenAI, dán API key của hệ thống.
2. Bật Override OpenAI Base URL.
3. Nhập Base URL https://api.vnaipro.app/v1.
4. Lưu bằng Save hoặc Verify tùy phiên bản, rồi bật sử dụng API key nếu có công tắc riêng.

Không điền key của gateway vào provider Anthropic với endpoint mặc định của hãng. Nếu bản Cursor của bạn không có Override OpenAI Base URL, chưa thể áp dụng hướng dẫn này; có thể dùng Cline hoặc OpenCode.

3. Thêm model

Trong danh sách model, chọn Add Custom Model, nhập đúng ID của model trong group rồi bật model đó. Tạo chat mới, chọn model vừa thêm thay vì Auto, gửi “Chỉ trả lời OK”.

4. Xác nhận request

Kiểm tra lịch sử sử dụng trên website của hệ thống. Có phản hồi nhưng không có request ở gateway thì chưa thể kết luận Cursor đang dùng key này; kiểm tra lại model, công tắc key và Base URL.

Nếu lỗi Verify, đọc chi tiết lỗi và đối chiếu model được dùng để kiểm tra với quyền của key. Nếu model chỉ hỗ trợ Responses hoặc không nằm trong phạm vi BYOK của Cursor, dùng client có adapter phù hợp. Không đổi tên model thành một model khác để vượt bước xác minh.

Nguồn: Bring your own API key.