Thêm toàn bộ model trong catalog vào Cherry Studio dưới dạng một provider.

Updated 2026-07-29

Cài đặt Model Services của Cherry Studio chấp nhận bất kỳ endpoint tương thích OpenAI nào: thêm một provider với type OpenAI, trỏ API address vào api.apisrouter.com, dán một key, và thêm model id bằng tay. Claude, GPT, DeepSeek, GLM, Kimi, và Qwen cùng nằm trong một picker trên desktop.

Câu trả lời nhanh: một provider trong Model Services.

Nhấn biểu tượng bánh răng ở thanh điều hướng bên trái của Cherry Studio, mở tab Model Services, và nhấn nút Add bên dưới danh sách provider. Đặt cho provider một tên dễ nhận (APIsRouter) và chọn OpenAI làm provider type, sau đó lưu. Giờ chọn provider mới trong danh sách và cấu hình nó: bật công tắc enable của nó, dán key của bạn vào field API key, và đặt API address thành https://api.apisrouter.com. Chú ý hình dạng: mặc định được ghi tài liệu của Cherry Studio là lấy địa chỉ gốc và tự nối thêm /v1/chat/completions, nên bạn nhập host mà không có /v1. Sau đó thêm model bằng nút Add trong phần model, mỗi entry một id catalog chính xác (claude-sonnet-4-6, deepseek-v4-flash, glm-5.2), và nhấn nút Check cạnh key để chạy kiểm tra trực tiếp với một model đã chọn.

Provider name:  APIsRouter
Provider type:  OpenAI

then, on the provider page:
API key:        sk-YOUR-APISROUTER-KEY
API address:    https://api.apisrouter.com
                (Cherry appends /v1/chat/completions)
Models → + Add: claude-sonnet-4-6, deepseek-v4-flash, glm-5.2
Check → pick a model → success

Cách Cherry Studio ghép URL request.

Cherry Studio (CherryHQ trên GitHub, khoảng 49K sao) là một desktop client có nguồn gốc Trung Quốc cho Windows, macOS, và Linux, nổi tiếng vì đóng gói sẵn preset cho hàng trăm provider và assistant. Bất cứ gì không có trong danh sách preset đi qua luồng custom provider ở trên, và phần đáng để hiểu là field API address. Mặc định được ghi tài liệu: bạn cung cấp địa chỉ gốc, và Cherry Studio nối thêm route OpenAI vào đó, nên https://api.apisrouter.com trở thành https://api.apisrouter.com/v1/chat/completions trên đường truyền. Nếu một provider dùng path không chuẩn, kết thúc địa chỉ bằng # sẽ vô hiệu hóa việc nối chuỗi hoàn toàn và địa chỉ được dùng đúng như gõ, đây là lối thoát được ghi trong tài liệu. Hành vi nối chuỗi quanh dấu / ở cuối đã thay đổi giữa các phiên bản, nên nếu request báo 404, hãy đọc URL cuối cùng trong lỗi thay vì đoán; dạng địa chỉ gốc cộng tự động nối thêm là cấu hình ổn định cho một gateway /v1 chuẩn. Khi đã cấu hình xong, mọi cuộc trò chuyện gửi chat completion chuẩn với model id bạn đã thêm dưới dạng chuỗi thuần. Vendor không quan trọng với định dạng trên đường truyền, đó là điều cho phép một provider entry mang cả id catalog Trung Quốc lẫn phương Tây cùng nhau.

Những chi tiết đáng giá: quản lý nhiều key và model.

Field API key chấp nhận nhiều hơn một key: tách các key bằng dấu phẩy tiếng Anh và Cherry Studio xoay vòng qua chúng từ trên xuống dưới theo từng request, một tính năng cân bằng tải được ghi tài liệu. Với một gateway đo lường theo từng key, điều này còn kiêm vai trò gán nhãn: một key cho công việc, một cho cá nhân, tắt xoay vòng bằng cách chỉ liệt kê một key. Các entry model là nhập tay và đó là một tính năng. Cherry Studio chỉ hiển thị đúng những gì bạn thêm, nên picker luôn được chọn lọc thay vì ngập trong một catalog được fetch về. Mỗi entry lấy id làm chuỗi trên đường truyền; nút Manage chỉnh sửa hoặc xóa entry sau này. Nhóm các id liên quan với cách đặt tên nhất quán và picker đọc như một thực đơn: tier nhanh (deepseek-v4-flash, claude-haiku-4-5-20251001), thế mạnh khu vực (glm-5.2, qwen3.7-plus, kimi-k2.6), frontier (claude-sonnet-4-6). Nút Check xác thực cặp key và address với một model bạn chọn, và đây là cách nhanh nhất để xác nhận provider trước khi trò chuyện thật. Một lần check thất bại với key đúng gần như luôn có nghĩa là field address mang một /v1 thừa làm nhân đôi path.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# add these ids verbatim in the provider's model list

Chọn model cho một cỗ máy làm việc trên desktop.

Một key nghĩa là so sánh chỉ là chuyển đổi trong picker. Chạy cùng một tuần công việc trên hai id ứng viên và để chi phí theo từng model trong console APIsRouter làm trọng tài đối chiếu với đánh giá của riêng bạn về chất lượng output.

  • Chat hàng ngày và viết lại nhanh sống ở tier nhanh: deepseek-v4-flash và claude-haiku-4-5-20251001 giữ cho cửa sổ luôn mở cảm giác miễn phí.
  • Công việc tiếng Trung là nơi các id khu vực xứng đáng có chỗ đứng: glm-5.2 và qwen3.7-plus cho soạn thảo và tài liệu, kimi-k2.6 cho đọc context dài.
  • claude-sonnet-4-6 đảm nhận các cuộc trò chuyện bạn chuyển tiếp mà không chỉnh sửa: phân tích cẩn trọng, văn bản gửi cho khách hàng, code bạn định ship.
  • Assistant của Cherry Studio có thể ghim model riêng theo từng vai trò, nên một assistant dịch thuật trên glm-5.2 và một assistant code trên claude-sonnet-4-6 cùng tồn tại phía sau một provider.
  • Thêm dòng có chủ đích; một picker sáu model được chọn lọc thì được dùng, còn một catalog dán nguyên vào thì chỉ bị cuộn qua.

Trả theo mức sử dụng · thấp hơn giá chính thức

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Mô hìnhGiá chính thứcGiá của chúng tôi
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
GLM-5.2$1.14 / $4.00 per M$1.10 / $4.00 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M
Qwen 3.7 Plus$0.29 / $1.14 per M$0.30 / $1.10 per M

Các lỗi thường gặp riêng của Cherry Studio.

Path bị nhân đôi là báo cáo phổ biến nhất: dán https://api.apisrouter.com/v1 vào một field vốn đã tự nối thêm /v1/chat/completions tạo ra URL /v1/v1 báo 404. Nhập địa chỉ gốc và để client tự xây route. Nếu bạn phải ghim một URL chính xác, dạng kết thúc bằng # tồn tại cho việc đó. Một lần Check thất bại với key đúng thường là do hình dạng địa chỉ ở trên; một lần Check thất bại với địa chỉ sạch là do key, và lưu ý rằng nhiều key phải được tách bằng dấu phẩy tiếng Anh, vì ký tự full-width dán từ bộ gõ tiếng Trung sẽ âm thầm phá vỡ danh sách. Model báo lỗi riêng lẻ trong khi các model khác hoạt động là vấn đề chính tả id; các entry là văn bản tự do và danh sách /v1/models là nguồn có thẩm quyền. Và hãy nhớ cài đặt là theo từng máy: một provider được cấu hình trên desktop của bạn không tồn tại trên laptop cho tới khi bạn lặp lại cài đặt hai phút đó hoặc dùng tính năng backup riêng của Cherry Studio. Lưu ý về version drift: Cherry Studio ra bản cập nhật thường xuyên và nhãn cài đặt di chuyển (Model Services cũng từng xuất hiện dưới tên Model Provider ở một số bản); luồng thêm provider, chọn type OpenAI, key, address, model vẫn giữ ổn định.

Ai định tuyến Cherry Studio qua một gateway.

  • Người dùng desktop song ngữ trộn GLM, Qwen, Kimi, và DeepSeek với Claude và GPT trong một picker, một số dư, không cần tài khoản theo từng vendor.
  • Người dùng ở châu Á muốn id Claude và GPT trên một số dư trả trước mà không cần thẻ phương Tây, cạnh các model khu vực họ đã dùng.
  • Power user chạy assistant của Cherry Studio theo từng vai trò, muốn mỗi assistant được ghim đúng vendor mà không phải quản lý năm key.
  • Người đã định tuyến các công cụ khác qua một gateway và muốn desktop client nằm trên cùng key và usage log.
  • Bất kỳ ai so sánh model khu vực và phương Tây trên công việc hàng ngày thực tế thay vì benchmark, nơi mỗi ứng viên chỉ là một dòng model.

Xác minh endpoint và debug cuộc trò chuyện đầu tiên.

Curl danh sách model trước và copy các id bạn định thêm; sau đó chạy một chat completion với model bạn định dùng hàng ngày. Khi cả hai đều pass, mọi thứ còn lại nằm ở trang provider. Bên trong Cherry Studio, chạy Check trước khi chat. Lỗi xác thực là field key hoặc dấu phân tách phẩy của nó. Lỗi 404 là hình dạng address, đọc URL đã ghép trong lỗi và đếm số đoạn /v1. Lỗi not-found trên một model cụ thể là chính tả id ở dòng đó. Khi cuộc trò chuyện đã thông suốt, console APIsRouter hiển thị model, số token, và chi phí theo từng request. Một desktop client dùng suốt ngày làm việc tạo ra một luồng ổn định các request nhỏ, và view usage theo từng key biến luồng đó thành các con số theo từng model, từng ngày, với id Trung Quốc và phương Tây trên cùng một trang.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"ping"}]}'

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

Làm sao để thêm một custom provider trong Cherry Studio?

Biểu tượng bánh răng, tab Model Services, Add. Đặt tên provider, chọn type OpenAI, lưu, sau đó trên trang của nó bật nó lên, dán key của bạn, đặt API address thành https://api.apisrouter.com, và thêm model id bằng tay. Xác thực bằng nút Check.

API address có nên bao gồm /v1 không?

Không. Mặc định được ghi tài liệu của Cherry Studio là lấy địa chỉ gốc và tự nối thêm /v1/chat/completions, nên hãy nhập https://api.apisrouter.com. Dán một host có /v1 sẽ nhân đôi path và báo 404. Để ghim một URL chính xác không chuẩn, kết thúc địa chỉ bằng # để vô hiệu hóa việc nối chuỗi.

Cherry Studio có thể chạy Claude, DeepSeek, và GLM qua một provider không?

Có. Id của mỗi dòng model di chuyển tới address dưới dạng chuỗi thuần, nên claude-sonnet-4-6, deepseek-v4-flash, glm-5.2, kimi-k2.6, và qwen3.7-plus có thể dùng chung một provider entry và một key, chuyển đổi được theo từng cuộc trò chuyện và từng assistant.

Tính năng key phân tách bằng dấu phẩy làm gì?

Nhiều key trong field API key, tách bằng dấu phẩy tiếng Anh, được xoay vòng từ trên xuống dưới qua các request, một tính năng cân bằng tải tích hợp sẵn. Với việc đo lường theo từng key phía gateway, nó còn hoạt động như gán nhãn; liệt kê một key duy nhất để giữ xoay vòng ở trạng thái tắt.

Vì sao nút Check thất bại?

Với key đúng, nguyên nhân thường gặp là address mang một /v1 thừa làm nhân đôi path đã ghép. Với address sạch, kiểm tra lại key và dấu phân tách của nó; dấu phẩy full-width từ bộ gõ tiếng Trung âm thầm phá vỡ danh sách nhiều key.

Vì sao model không tự động điền như các provider preset?

Custom provider chỉ liệt kê đúng những gì bạn thêm; Cherry Studio không fetch catalog của một endpoint tùy chỉnh. Điều đó giữ cho picker luôn được chọn lọc. Lấy id từ danh sách /v1/models và thêm những cái bạn thực sự dùng, rồi mở rộng danh sách vào ngày bạn cần thêm cái khác.