API AI giá rẻ cho mọi client: cấu hình Cursor, Cline, Cherry Studio
Điểm chính
- Một khóa gắn với một nhóm, và nhóm là tập model cùng một giao thức, cùng một mức giá. Mọi model trong nhóm đó gọi được bằng chính khóa ấy — đó là nghĩa thực tế của API AI giá rẻ chỉ với một khóa.
- Nếu bạn dùng cả hai họ giao thức, bạn sẽ có hai khóa trên cùng một host. Host vẫn chỉ một; khóa mới là thứ bị giới hạn theo nhóm.
- Cursor, Cline, Cherry Studio và Claude Code đều chỉ hỏi đúng hai giá trị: base URL và khóa. Khác nhau ở chỗ mỗi client cất hai giá trị đó ở đâu, và nó chờ tiền tố đường dẫn nào.
- Cách tự kiểm tra: trước khi cấu hình bất cứ thứ gì, hãy hỏi chính khóa xem nó gọi được gì. Một yêu cầu tới
/v1/modelstrả về đúng danh sách model mà cổng sẽ áp cho khóa đó — cũng chính là danh sách mà ô Model của client phải khớp.
Câu này hứa gì, và không hứa gì
Nhiều người tới bước này sau khi đọc đâu đó câu "một khóa dùng cho mọi model", rồi phát hiện khóa của mình từ chối đúng thứ họ cần. Nhầm lẫn hầu như không nằm ở khóa, mà nằm ở nhóm.
Khóa được cấp theo nhóm. Nhóm quyết định hai việc: có những model nào, và mỗi token tốn bao nhiêu trong nhóm đó. Mọi model trong nhóm đều gọi được bằng một khóa, từ bất kỳ client nào, trên bất kỳ thiết bị nào — nửa lời hứa này đúng. Thứ một khóa không làm được là bắc qua hai họ giao thức: bên tương thích OpenAI và bên tương thích Anthropic là hai nhóm riêng. Quy trình cần cả hai thì sẽ giữ hai khóa.
Cả hai khóa dùng trên cùng một host, cùng một tài khoản, cùng một số dư và cùng một bản ghi usage. Phần còn lại của cấu hình không nhân đôi.
Hai họ giao thức quyết định nhiều hơn cả khóa
Một client chỉ nói chuyện được với nhóm dùng đúng giao thức của nó. Đây là điểm giải thích phần lớn các báo lỗi kiểu "công cụ này chạy được, công cụ kia thì không".
| Thứ bạn đang nối | Giao thức nó dùng | Giá trị cần đổi |
|---|---|---|
| Claude Code | Anthropic | base URL cho các yêu cầu Anthropic |
| Cline, nhà cung cấp "Anthropic" | Anthropic | cũng giá trị đó, qua tuỳ chọn base URL riêng |
| Cline, nhà cung cấp "OpenAI Compatible" | OpenAI | base URL và thêm một model ID |
| Cursor, dùng khóa của bạn | OpenAI | base URL OpenAI đã bị ghi đè |
| Cherry Studio | loại nhà cung cấp bạn chọn | host và khóa |
Tiền tố đường dẫn đi theo giao thức. Nhóm client họ OpenAI nhận base URL đã có sẵn /v1 ở cuối; nhóm client họ Anthropic nhận host rồi tự nối đường dẫn phía sau. Dán sai dạng sẽ ra lỗi 404 trông giống như khóa hỏng — vì vậy hãy dán trước, đọc lỗi sau.
Trước khi cấu hình, hỏi khóa xem nó gọi được gì
curl https://kuaiapi.net/v1/models \
-H "Authorization: Bearer sk-khoa-cua-ban"Kết quả trả về là danh sách model của nhóm mà khóa đó thuộc về — đúng danh sách mà cổng sẽ áp cho mọi yêu cầu. Đọc hai thứ: model bạn định dùng có trong đó không, và kết quả có phải JSON hay chỉ là một trang lỗi. Hãy giữ lại kết quả: các giá trị id trong đó chính là thứ ô Model của client cần. Tên model chép từ tài liệu của nền tảng khác thường sẽ không chạy.
Cách tự kiểm tra: gửi một yêu cầu với tên model mà bạn biết chắc là sai. Bạn sẽ nhận lỗi không tìm thấy model — và vì yêu cầu lỗi không bị trừ phí, phép thử này không tốn gì. Nếu một yêu cầu lỗi lại hiện ra như một khoản bị trừ trong bản ghi usage, hãy dừng lại và đối chiếu trước khi nạp thêm.
Cline
Cline có hai cửa, và dùng cửa nào là do giao thức của nhóm bạn quyết định.
- OpenAI Compatible — chọn nhà cung cấp là "OpenAI Compatible", rồi điền Base URL, API Key và model ID, sau đó bấm Verify để xác nhận kết nối. Đây là cửa cho nhóm giao thức OpenAI.
- Anthropic — dán khóa, rồi tích tuỳ chọn dùng base URL riêng và nhập host. Đây là cửa cho nhóm giao thức Anthropic.
Lỗi phổ biến nhất là chọn nhà cung cấp theo tên model thay vì theo giao thức: một model Claude nằm trong nhóm giao thức OpenAI thì thuộc cửa OpenAI Compatible, không phải cửa Anthropic.
Cursor
Trong Cursor, mở Settings, vào Models, dán khóa vào ô OpenAI API Key, rồi bật Override OpenAI Base URL và trỏ về endpoint của bạn.
Có hai giới hạn nên biết trước khi bật, vì chúng thuộc về cơ chế ghi đè chứ không phải của một endpoint cụ thể:
- Khi ghi đè đang bật, các model không thuộc OpenAI của chính Cursor sẽ không dùng được, nên danh sách chọn model do model ID từ endpoint của bạn quyết định.
- Tab completion không nằm trong phạm vi ghi đè và vẫn dùng model dựng sẵn của Cursor.
Nếu nhóm của bạn phụ thuộc vào model dựng sẵn của Cursor, hãy quyết định làm việc ở chế độ nào ngay từ đầu thay vì bật tắt ghi đè giữa phiên.
Cherry Studio
Trang model service của Cherry Studio cho phép thêm một mục và chọn loại của nó. Loại chính là quyết định giao thức: chọn loại khớp với nhóm của bạn, dán host và khóa, rồi thêm các model ID từ danh sách đã lấy ở trên. Vì danh sách model được nhập theo từng nhà cung cấp chứ không tự dò, một ID không có trong danh sách của nhóm sẽ lỗi ngay lúc gọi.
Claude Code
Claude Code là trường hợp giao thức Anthropic, và nó đọc endpoint cùng khóa từ biến môi trường hoặc tệp cấu hình chứ không qua hộp thoại cài đặt. Trang tham chiếu settings trong tài liệu Anthropic liệt kê đầy đủ, gồm ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN, cùng cách tệp settings và profile đè lên nhau theo thứ tự nào. Hãy trỏ base URL về host và dùng khóa thuộc nhóm giao thức Anthropic.
Câu hỏi thường gặp
Một API key dùng cho nhiều project được không? Được, trong phạm vi nhóm của nó. Cùng một khóa có thể nằm trong editor, terminal và một job CI — không có gì buộc khóa vào một thiết bị. Lý do để tách ra vẫn là phạm vi ảnh hưởng: khóa riêng cho từng project giúp bạn thu hồi một cái mà không đụng tới phần còn lại, và giữ usage quy được về đúng nơi khi đọc bản ghi.
Dùng mọi model AI ở một chỗ được không? Một chỗ thì được: một host, một tài khoản, một số dư và một bản ghi usage. Còn một khóa thì chỉ trong một nhóm. Phần lớn người dùng cuối cùng chạy hai hoặc ba khóa cạnh nhau trên cùng một host, và đó là hình dạng đúng, không phải cách lách.
Khóa của tôi thực sự gọi được những model nào? Những model xuất hiện trong kết quả /v1/models của chính khóa đó. Cổng áp đúng danh sách này lúc gọi, nên model không có trong đó sẽ lỗi dù bạn điền gì vào client.
Có phải đổi SDK không? Không, miễn là client đã dùng đúng giao thức của nhóm bạn. Chỉ hai giá trị đổi; thư viện, prompt và công cụ giữ nguyên. Nếu client dùng giao thức còn lại, cách sửa là một khóa thuộc nhóm tương ứng, không phải một lớp tương thích.
Việc cần làm tiếp
Hai trang công khai giải quyết phần lớn câu hỏi còn lại trước khi bạn giao một quy trình cho endpoint nào: model plaza công khai đơn giá từng model và hệ số từng nhóm mà không cần đăng nhập, còn trang trạng thái cho thấy từng nhóm đang chạy thế nào, kể cả lúc chạy không tốt.
Nếu bạn nối riêng Claude Code, Đổi base URL Claude Code: điều gì thực sự thay đổi đi qua thứ tự ưu tiên của các nguồn cấu hình. Còn các câu hỏi ở mức nhà vận hành — yêu cầu lỗi, hoàn tiền, bản ghi theo từng yêu cầu — API Claude giá rẻ có an toàn không? 5 điều nên kiểm tra đi lần lượt. Phần endpoint và khóa được ghi trong tài liệu tiếng Việt, và trang hoàn tiền ghi rõ quy trình cùng thời hạn xử lý.