Dùng Cursor, Cline và Continue với API TaiKhoanGiaRe

Hướng dẫn cấu hình Cursor, Cline và Continue dùng API TaiKhoanGiaRe: đổi base URL, dán key, chọn model, thử trước ở Playground.

Cursor, Cline và Continue đều hỗ trợ provider "OpenAI-compatible", nên việc trỏ chúng về TaiKhoanGiaRe chỉ gồm ba bước: đổi base URL, dán secret key, chọn model id. Bài này đi từng bước cho cả ba công cụ, kèm cách kiểm tra key trước khi gắn vào editor, cách so sánh chi phí giữa các model, và một số lỗi thường gặp khi cấu hình sai.

Chuẩn bị: lấy key và base URL

Đăng nhập hoặc tạo tài khoản ở /login.html, vào /dashboard.html > tab API keys. Mỗi tài khoản chỉ có đúng một secret key, được tạo tự động khi đăng ký. Bấm Show để xem key, hoặc Rotate nếu cần đổi key mới (lưu ý Rotate sẽ vô hiệu hoá key hiện tại ngay lập tức, nên nếu đã gắn key vào cả Cursor, Cline, Continue thì phải cập nhật lại ở cả ba nơi sau khi Rotate).

Base URL dùng cho các client kiểu OpenAI SDK (Cursor, Cline, Continue đều thuộc nhóm này):

https://taikhoangiare.vn/v1

Xác thực bằng header Authorization: Bearer <key>. Nếu công cụ nào yêu cầu dán nguyên request mẫu để test, có thể dùng cách gọi cURL ở phần dưới bài, hoặc xem thêm cách lấy key và gọi thử trong Lấy API key và gọi thử bằng cURL trong 3 phút.

Chọn model trước khi cấu hình

Vào tab Models & API trong dashboard, hoặc trang công khai /models.html để xem danh sách model, lọc theo khả năng vision/tools/reasoning. Vì cả ba editor này đều dùng model cho việc viết code và agent, nên chọn model có khả năng tools (function calling) nếu muốn dùng tính năng edit file tự động, chạy terminal hoặc tạo pull request.

Một vài model id đang bán, kèm giá tham khảo mỗi 1 triệu token:

Ngoài 5 model này, tab Models & API còn liệt kê thêm các id khác như claude-haiku-4-5, claude-opus-4-8, gpt-6-luna, grok-4.6, kimi-k3... Khi chọn model cho Cursor/Cline/Continue, nên gõ chính xác id như hiển thị trong dashboard, vì nếu sai id, API sẽ trả lỗi model không tồn tại thay vì tự động dùng model gần giống.

Prompt caching được bật sẵn cho các model này, nên các lượt đọc lại context cũ (ví dụ codebase lớn mà agent giữ trong context qua nhiều bước) được tính theo giá cache read, rẻ hơn giá input thường. Đây là lý do các agent coding (Cline, Continue agent mode) thường rẻ hơn nhiều so với tính theo giá input gốc, vì phần lớn token lặp lại được đọc từ cache.

Thử trước ở Playground

Trước khi gắn key vào editor, nên thử nhanh ở tab Playground trong dashboard: chọn model, đặt system prompt, temperature, max output tokens, bật stream để xem phản hồi chạy từng chunk có ổn không. Việc này giúp xác nhận key hoạt động và model trả lời đúng ý trước khi cấu hình phức tạp hơn trong Cursor/Cline/Continue, tránh trường hợp vừa debug sai config vừa nghi ngờ model không tốt.

Nếu muốn kiểm tra bằng cURL thay vì Playground, có thể gọi trực tiếp:

curl https://taikhoangiare.vn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Xin chào"}]
  }'

Thấy response trả về đúng là key và base URL đã hoạt động, có thể gắn vào editor. Nếu không nhận được phản hồi hợp lệ, kiểm tra lại ba thứ: key đã Show đúng chưa, model id có đúng chính tả như trong Models & API không, và tài khoản còn credit hay không (xem ở Overview trong dashboard).

Cấu hình Cursor

Trong Cursor, vào phần cài đặt model, chọn provider dạng OpenAI-compatible (custom API). Điền:

• Base URL: https://taikhoangiare.vn/v1
• API key: secret key lấy từ dashboard
• Model id: ví dụ claude-sonnet-5 hoặc gpt-6-astra, gõ đúng id như trong Models & API

Lưu lại và thử một yêu cầu nhỏ, như hỏi giải thích một đoạn code trong project, trước khi dùng cho tác vụ edit lớn. Nếu Cursor báo lỗi kết nối, kiểm tra lại base URL có đang trỏ nhầm sang base Anthropic (không có /v1) hay không, vì hai base URL này dùng cho hai kiểu client khác nhau. Base https://taikhoangiare.vn/v1 dùng cho client kiểu OpenAI SDK như Cursor, còn base không có /v1 chỉ dùng cho client kiểu Anthropic SDK.

Cấu hình Cline

Cline (và Roo Code) chạy như extension VS Code, có mục chọn API Provider. Chọn OpenAI Compatible, sau đó điền tương tự:

• Base URL: https://taikhoangiare.vn/v1
• API Key: secret key
• Model: nhập model id từ danh sách ở /models.html

Vì Cline hay chạy agent nhiều bước (đọc file, sửa file, chạy lệnh), nên model có cache tốt sẽ tiết kiệm hơn khi context lặp lại giữa các bước. Theo bảng tính sẵn, một lượt agent gồm 100.000 token đọc cache + 5.000 token input mới + 1.000 token output tốn như sau với từng model:

Nếu Cline dùng để chạy agent liên tục cả ngày (đọc file lớn, sửa nhiều file), nên ưu tiên deepseek-v4-flash hoặc gpt-5.5 cho các task đơn giản, và chuyển sang claude-sonnet-5 hoặc claude-opus-5-5 khi cần suy luận phức tạp hơn. Có thể đổi model id trong Cline bất cứ lúc nào, không cần tạo key mới.

Cấu hình Continue

Continue (VS Code và JetBrains) cấu hình qua file config, dùng provider openai với apiBase. Ví dụ phần model trong config của Continue:

{
  "models": [
    {
      "title": "TaiKhoanGiaRe",
      "provider": "openai",
      "model": "claude-sonnet-5",
      "apiKey": "YOUR_KEY",
      "apiBase": "https://taikhoangiare.vn/v1"
    }
  ]
}

Sau khi lưu, chọn model này trong danh sách model của Continue rồi thử chat ngay trong editor để xác nhận hoạt động. Có thể thêm nhiều block model trong cùng mảng models để chuyển đổi nhanh giữa các id, ví dụ thêm một block khác với "model": "gpt-5.5" cho các câu hỏi đơn giản, tiết kiệm hơn khi không cần model mạnh nhất.

Lỗi thường gặp khi cấu hình

Một số lỗi hay gặp khi gắn API TaiKhoanGiaRe vào Cursor, Cline, Continue:

• 401 Unauthorized: key sai hoặc đã bị vô hiệu do vừa Rotate ở nơi khác. Vào dashboard, tab API keys, bấm Show để lấy lại key hiện hành.
• 404 hoặc "model not found": model id gõ sai, thường do gõ thiếu dấu gạch hoặc nhầm số phiên bản. Đối chiếu lại chính xác với danh sách ở Models & API hoặc /models.html.
• Request treo lâu không trả lời: kiểm tra lại base URL có đúng https://taikhoangiare.vn/v1 không, một số công cụ tự thêm hoặc thiếu dấu / ở cuối gây lỗi route.
• Credit không đủ: nếu Overview trong dashboard báo số dư thấp, cần nạp thêm ở tab Billing bằng VietQR qua PayOS trước khi tiếp tục dùng agent.

Nếu job bị lỗi do hệ thống (không phải do key hoặc model sai), credit tương ứng sẽ được hoàn lại, không bị trừ oan.

Theo dõi chi phí sau khi dùng

Vào tab Usage trong dashboard để xem chi tiêu theo ngày/7 ngày/30 ngày, lọc theo sản phẩm. Khi cần nạp thêm, vào tab Billing, nạp bằng VietQR qua PayOS; xem các gói ở /pricing.html. Các gói hiện có: Starter 99.000đ (1500 credit), Pro 279.000đ (5000 credit), Business 679.000đ (13000 credit), Enterprise 1.339.000đ (30000 credit), với 1 credit tương ứng 55,8đ.

Nếu dùng chat thông thường trong Continue hoặc Cursor (không agent nhiều bước), chi phí mỗi tin nhắn (1.000 token input + 500 token output) theo bảng tính sẵn là:

Nếu muốn tìm hiểu thêm cách giảm hoá đơn khi dùng agent (ví dụ tối ưu context, tận dụng cache tốt hơn), có thể tham khảo Tối ưu chi phí token khi gọi API LLM.

Mở rộng: MCP và các công cụ khác

Ngoài chat và agent coding thuần văn bản, TaiKhoanGiaRe còn có MCP server tại https://taikhoangiare.vn/mcp với các tool như chat, list_models, generate_image, generate_video, text_to_speech, job_status, balance. Nếu công cụ coding của bạn hỗ trợ kết nối MCP, có thể xem hướng dẫn chung ở /integrations.html?app=mcp. Đây là lựa chọn riêng, không bắt buộc khi chỉ cần dùng model chat/agent qua base URL OpenAI-compatible như trong bài này.

Nếu bạn dùng nhiều công cụ khác ngoài Cursor, Cline, Continue, danh sách hướng dẫn đầy đủ (Claude Code, Codex CLI, Claude Desktop, VS Code Chat, OpenCode, AutoCAD, Blender, n8n...) nằm ở /integrations.html.

Kết luận

Cursor, Cline và Continue dùng cùng cơ chế OpenAI-compatible nên cấu hình gần như giống nhau: base URL https://taikhoangiare.vn/v1, secret key duy nhất lấy từ dashboard, model id chọn từ Models & API. Nên thử ở Playground hoặc bằng cURL trước, rồi mới gắn vào editor để tránh mất công debug sai chỗ. Khi chạy agent nhiều bước, ưu tiên model rẻ cho task đơn giản và model mạnh hơn cho task cần suy luận, theo dõi chi tiêu ở tab Usage để kiểm soát hoá đơn.

Câu hỏi thường gặp

Base URL dùng cho Cursor, Cline, Continue có khác nhau không?

Không, cả ba đều dùng chung base URL OpenAI-compatible là https://taikhoangiare.vn/v1, chỉ khác cách điền trong giao diện hoặc file config của từng công cụ.

Mỗi tài khoản có nhiều secret key để dùng riêng cho từng editor không?

Không, mỗi tài khoản chỉ có đúng một secret key, tạo tự động khi đăng ký; bạn chỉ có thể Show để xem lại hoặc Rotate để đổi key mới, không có tính năng tạo thêm key.

Làm sao biết model id nào đang hỗ trợ tools để dùng agent trong Cline?

Vào tab Models & API trong dashboard hoặc trang /models.html, dùng bộ lọc theo khả năng tools để xem các model phù hợp cho agent chỉnh sửa file tự động.

Nếu request từ Cursor/Cline/Continue bị lỗi thì có mất credit không?

Không, các job lỗi do hệ thống được hoàn credit, bạn chỉ bị trừ tiền cho các request thành công; còn lỗi do nhập sai key hoặc model id thì request sẽ không chạy được nên không phát sinh chi phí.

← Về trang Blog