Tích hợp với Coding Agents

Cursor

Cursor là gì?

Cursor là trình soạn thảo code tích hợp AI, xây dựng trên nền VS Code. Cursor có chế độ agent để lập trình tự động, tab completions, chỉnh sửa nội tuyến, một CLI và các cloud agent — tất cả đều chạy trên các model hàng đầu từ OpenAI, Anthropic, Google cùng nhiều provider khác.

Khi route Cursor qua Trạm AI, người dùng truy cập được hàng trăm model chỉ với một API key duy nhất, có provider failover tự động và theo dõi mức sử dụng tập trung.

Quick start

Cursor hỗ trợ Trạm AI thông qua tính năng Override OpenAI Base URL. Tính năng này route các request từ slot provider OpenAI của Cursor qua Trạm AI thay vì gửi thẳng đến OpenAI.

Bước 1: Lấy Trạm AI API Key

  1. Đăng ký hoặc đăng nhập tại Trạm AI
  2. Truy cập trang API Keys
  3. Tạo một API key mới
  4. Sao chép key(bắt đầu bằng tram_sk-...)

Bước 2: Cấu hình Cursor

  1. Mở Cursor Settings (biểu tượng bánh răng hoặc Cmd/Ctrl + ,)
  2. Truy cập Models, sau đó mở rộng phần API Keys
  3. Bật OpenAI API Key, rồi:
    • Dán Trạm AI API key vào trường OpenAI API Key
    • Bật Override OpenAI Base URL và đặt giá trị thành:
      lines
      https://api.staging.tram.ai.vn/v1

Bước 3: Thêm Model

Sau khi kết nối, hãy thêm các model muốn sử dụng. Trong phần Models, nhấp + Add model và nhập một model ID của Trạm AI:

  • ~anthropic/claude-sonnet-latest
  • ~google/gemini-flash-latest
  • ~openai/gpt-mini-latest
  • ~anthropic/claude-haiku-latest

Người dùng có thể tìm model ID chính xác cho từng model trên trang models của Trạm AI.

Bước 4: Chọn một Model

Mở bộ chọn model trong bảng chat hoặc agent và chọn một trong các model vừa thêm. Từ giờ, các request sẽ được route qua Trạm AI.

Vì sao nên dùng Trạm AI với Cursor?

Truy cập hàng trăm Model

Tính năng BYOK tích hợp sẵn của Cursor chỉ hỗ trợ một số ít provider (OpenAI, Anthropic, Google, Azure, AWS Bedrock). Với Trạm AI, người dùng có thể truy cập các model từ DeepSeek, Meta, xAI, Mistral, Cohere, và nhiều provider khác — tất cả đều thông qua một slot provider OpenAI duy nhất.

Provider Failover

Khi một provider không khả dụng hoặc chạm rate limit, Trạm AI tự động route sang provider khác, giúp phiên làm việc lập trình không bị gián đoạn.

Kiểm soát cấp tổ chức

Trạm AI cung cấp khả năng quản lý budget tập trung cho các nhóm. Người dùng có thể đặt giới hạn chi tiêu, phân bổ credit và giám sát mức sử dụng của các developer dùng Cursor ngay trong Trạm AI Activity Dashboard.

Provider Routing

Người dùng có thể kiểm soát provider upstream nào xử lý các request của mình bằng cách thêm hậu tố routing vào tên model, hoặc cấu hình tùy chọn provider trong Trạm AI Chat:

  • Thêm :nitro để route tối ưu cho throughput (ví dụ: ~anthropic/claude-sonnet-latest:nitro)
  • Thêm :floor để route tối ưu cho chi phí

Để biết thêm các tùy chọn routing, hãy xem tài liệu Provider Routing.

Hạn chế

  • Tab completions không chịu ảnh hưởng từ cài đặt BYOK — chúng luôn dùng các model tích hợp sẵn của Cursor.
  • Chế độ Auto và Composer 2 có thể không route qua API key— hãy xem tài liệu của Cursor để biết hành vi hiện tại.
  • Chỉ những model truy cập được qua endpoint tương thích OpenAI của Trạm AI mới hoạt động. Hầu hết các model chat và reasoning đều được hỗ trợ.

Khắc phục sự cố

  • “Invalid API key”: Hãy chắc chắn đang dùng Trạm AI API key (bắt đầu bằng tram_sk-...), không phải key của OpenAI.
  • Model not found: Đảm bảo model ID khớp chính xác với định dạng trên tram.ai/models (ví dụ: ~anthropic/claude-sonnet-latest, không phải claude-sonnet-latest).
  • Base URL: Hãy chắc chắn rằng URL override là https://api.staging.tram.ai.vn/v1 (có /v1 ở cuối).

Resources