Cursor

Cursor có thể định tuyến yêu cầu mô hình qua cổng API OpenAI compatible tương thích của TokenHub. Giữ nguyên cách cài đặt chính thức, sau đó thay API key, Base URL và model ID.

Use https://us-api.tokenhub.com/v1 as the OpenAI Base URL override. Depending on the Cursor version and selected model, Cursor may use Chat Completions or Responses-style requests, so do not assume a single endpoint path.

Khi nào nên dùng

Bắt đầu với repository nhỏ hoặc dự án thử nghiệm. Trước tiên yêu cầu công cụ đọc file, giải thích mã hoặc lập kế hoạch, rồi mới bật chỉnh sửa.

Cài đặt hoặc mở công cụ

Làm theo tài liệu chính thức của Cursor để cài đặt hoặc mở công cụ. Nếu giao diện thay đổi, ưu tiên tài liệu hiện tại.

Với công cụ CLI, hãy kiểm tra executable trước khi thêm thông tin xác thực TokenHub:

# open the tool, then open its model or provider settings

Chuẩn bị thông tin xác thực TokenHub

Tạo TokenHub API key và chọn một mô hình phù hợp từ danh sách mô hình TokenHub.

export TOKENHUB_API_KEY="sk-..."

Lưu key trong shell cục bộ, kho bí mật của IDE hoặc trường API key an toàn của công cụ. Không commit key vào repository.

Cấu hình nhà cung cấp TokenHub

Trong phần Models, Providers, API Keys hoặc OpenAI Compatible, nhập các giá trị dưới đây.

Giá trị provider

Cursor officially supports BYOK for specific providers and standard chat models. A custom OpenAI-compatible endpoint is currently a limited Base URL override, not a first-class custom provider.

Trường	Giá trị
Settings	Cursor Settings → Models → API Keys
API key field	OpenAI API Key
Base URL option	Override OpenAI Base URL
Base URL	`https://us-api.tokenhub.com/v1`
Mô hình	A TokenHub model compatible with the request format Cursor sends

Vị trí file cài đặt

Trường	Giá trị
macOS	`~/Library/Application Support/Cursor/User/settings.json`
Windows	`%APPDATA%\Cursor\User\settings.json`
Linux	`~/.config/Cursor/User/settings.json`

Khi extension sở hữu schema riêng, hãy dùng UI cài đặt trước. UI sẽ lưu cùng giá trị vào user settings và tránh phải đoán private key có thể đổi theo phiên bản.

Custom keys apply only to standard chat models. Tab Completion and Cursor-owned models continue through Cursor. Some current Cursor versions can also send a Responses-shaped body to a Chat Completions path through the override, so verify a read-only chat before relying on Agent mode. If the Base URL override is absent or the request format is rejected, that Cursor version cannot connect to TokenHub reliably.

Do not map Chat, Agent, Composer, Apply, Fast, or Tab as if they were equivalent custom-provider slots. Start with one standard chat model and treat every other feature as unsupported until its requests appear successfully in TokenHub logs.

Biến môi trường tạm thời chỉ để debug

Khi extension sở hữu schema riêng, hãy dùng UI cài đặt trước. UI sẽ lưu cùng giá trị vào user settings và tránh phải đoán private key có thể đổi theo phiên bản.

Chỉ dùng biến tạm thời để kiểm tra key, mạng và tên mô hình. Sau khi xác minh, chuyển cùng giá trị vào cấu hình bền vững ở trên.

Xác minh kết nối

Trước tiên dùng prompt chỉ đọc để xác nhận mô hình đọc được ngữ cảnh và không sửa file. Sau đó mới thử chỉnh sửa hoặc tác vụ agent.

Đọc README của dự án và tóm tắt trong ba câu. Không chỉnh sửa file.

Sau khi prompt chạy thành công, kiểm tra log TokenHub để xác nhận tên mô hình, endpoint, lượng token và billing group.

Khắc phục sự cố

Hiện tượng	Cách xử lý
401 hoặc lỗi xác thực	Kiểm tra `TOKENHUB_API_KEY` còn hợp lệ và đã lưu trong cùng terminal, IDE hoặc profile client.
404 hoặc không tìm thấy mô hình	Dùng model ID có trong workspace TokenHub và phù hợp với giao thức đã chọn.
Sai endpoint	Giữ Base URL đúng như phần trên. Công cụ tương thích OpenAI thường cần `/v1`; công cụ tương thích Claude thường không cần.
Request timeout	Kiểm tra đường mạng tới `https://us-api.tokenhub.com`, proxy settings và allowlist của workspace.
Công cụ dùng mô hình khác	Kiểm tra lại mọi trường chat, edit, apply, fast hoặc autocomplete.

Trên trang này