Đường dẫn cấu hình API trong Cherry Studio là Settings → Model Provider → Add Provider. Nhập API Key, điền lần lượt địa chỉ gốc vào các ô OpenAI và Anthropic trong Endpoint settings, sau đó lưu, dùng ‘Sync models’ để tải model và dùng ‘Check’ để kiểm tra. Điều cần biết trước: Cherry Studio không có giao diện tiếng Hàn, nên menu được ghi nguyên văn bằng tiếng Anh. Trang này dựa trên v2.1.4 phát hành ngày 30 tháng 9 năm 2026; vì màn hình thêm nhà cung cấp đã thay đổi đáng kể trong v2, hướng dẫn kiểu ‘Type: OpenAI’ của thời v1 không còn khớp với giao diện.
Đối tượng là phiên bản máy tính để bàn của CherryHQ/cherry-studio (AGPL-3.0, Windows·macOS·Linux). Tính đến ngày 1 tháng 10 năm 2026, kho mã nguồn chưa được chuyển sang trạng thái lưu trữ và phiên bản mới nhất là v2.1.4. Ứng dụng cùng tên trên App Store là ứng dụng không liên quan của nhà phát triển khác. Giao diện tích hợp có 13 ngôn ngữ và không có tiếng Hàn (theo các tệp dịch giao diện của v2.1.4), vì vậy hướng dẫn này giả định bạn dùng giao diện tiếng Anh.
Cấu hình từng bước
Settings → Model Provider → Add Provider
(대화상자 제목: Add Custom Provider)
Provider Name Kunavo
API Key sk-kn-...
Endpoint settings
OpenAI https://api.kunavo.com/v1
Anthropic https://api.kunavo.com
More options
OpenAI Responses https://api.kunavo.com/v1 (선택)
Image Generation Base URL https://api.kunavo.com/v1 (선택)
Gemini 비워 둠
→ Save → 모델 목록에서 "Sync models" → 쓸 모델 추가 → "Check"- Trong Settings → Model Provider, nhấn Add Provider. Tiêu đề hộp thoại mở ra là ‘Add Custom Provider’. Nếu cần dịch vụ thuộc nhóm Coding Plan, nhiều tài khoản hoặc tách dự án, bạn cũng có thể bắt đầu từ preset hiện có thông qua ‘Start from a preset (optional)’ ở phía trên.
- Nhập Provider Name và API Key.
- Trong Endpoint settings có sẵn hai ô OpenAI và Anthropic. Cần ít nhất một endpoint văn bản (để trống sẽ báo lỗi ‘Configure at least one text endpoint’). Nếu điền cả hai ô, bạn có thể chọn model không chỉ cho chat mà còn cho Agent hoặc các tính năng dùng định dạng Anthropic.
- Mở rộng More options sẽ thấy các ô OpenAI Responses, Gemini, Image Generation Base URL và Image Edit Base URL. Để trống các ô không dùng.
- Sau khi lưu, hãy kiểm tra nhà cung cấp đó đã được kích hoạt (Enable) chưa. Theo tài liệu chính thức, nhà cung cấp chỉ được cấu hình nhưng chưa kích hoạt sẽ không xuất hiện trong danh sách chọn model. Đây là nguyên nhân phổ biến nhất của việc ‘khóa không hoạt động’.
- Trong danh sách model, dùng Sync models để tải model, thêm model muốn dùng, rồi dùng Check để kiểm tra một model.
Cách ghi địa chỉ: chỉ dùng địa chỉ gốc
Theo mã nguồn v2.1.4, mỗi ô cần địa chỉ gốc. Nếu thiếu phần phiên bản, ứng dụng sẽ tự động thêm /v1 (nếu đã có thì không thêm), sau đó nối đường dẫn cố định theo từng ô. Bên dưới mỗi ô có ‘Request path’ hiển thị URL cuối; hãy kiểm tra trước khi lưu.
| Ô | Đường dẫn Cherry Studio nối thêm | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | Được hỗ trợ |
| Anthropic | /messages | Được hỗ trợ |
| OpenAI Responses (More options) | /responses | Được hỗ trợ |
| Image Generation Base URL (More options) | /images/generations | Được hỗ trợ |
| Image Edit Base URL (More options) | /images/edits | Được hỗ trợ |
| Gemini (More options) | /models/{model}:generateContent | Không được hỗ trợ, để trống |
Có hai lỗi thường gặp. Nếu dán URL đầy đủ đã chứa /chat/completions hoặc /messages, đường dẫn sẽ bị nối hai lần và gây lỗi 404. Ngoài ra, # ở cuối là ký hiệu ‘Add # at the end to disable the automatically appended API version’ theo hướng dẫn trên màn hình, tức tắt việc tự động thêm phiên bản; nếu gắn vào endpoint tiêu chuẩn thì /v1 sẽ bị thiếu. Để kiểm tra chính địa chỉ và khóa, lệnh dưới đây là cách nhanh nhất.
curl https://api.kunavo.com/v1/models \
-H "Authorization: Bearer $KUNAVO_API_KEY"Cấu hình model cơ bản để tiết kiệm chi phí
Cherry Studio gọi model ở phía sau không chỉ cho chat. Quick Model được dùng cho ‘các tác vụ đơn giản như đặt tên cuộc trò chuyện và trích xuất từ khóa tìm kiếm’ theo mô tả trên màn hình; hướng dẫn cũng khuyên ‘chọn model nhẹ và tránh model suy luận’. Đặt model rẻ ở đây sẽ tránh việc model đắt được chạy mỗi lần trò chuyện. Hãy cấu hình riêng cả Translate Model. Khi chọn nhiều model để hỏi cùng lúc, mỗi model sẽ tạo một yêu cầu riêng và được tính phí riêng. Số tiền trong thống kê sử dụng của ứng dụng là ước tính quy đổi theo giá công khai, nên với tuyến được giảm giá, con số này có thể cao hơn thực tế. Đổi đơn giá trong phần cài đặt model sang mức phí thực tế sẽ khắc phục. Xem trang tiếng Anh Cherry Studio API cost để biết thêm.
Lưu ý và thanh toán khi dùng Kunavo
- Phạm vi xác minh: Cấu hình này được viết dựa trên mã nguồn Cherry Studio và tài liệu chính thức; Kunavo chưa xác minh bằng cách thực sự kết nối Cherry Studio với endpoint của mình và chạy thử. Hãy giữ nguyên tuyến đang dùng và thử nghiệm cẩn thận.
- Chỉ chat và hình ảnh: Kunavo không có model embedding, nên tìm kiếm vector trong cơ sở tri thức cần một nhà cung cấp khác hoặc model embedding cục bộ. Tài liệu chính thức cho biết cơ sở tri thức vẫn hoạt động bằng tìm kiếm từ khóa BM25 ngay cả khi không có model embedding.
- Công cụ MCP: Các công cụ được thêm trong Settings → MCP Servers chỉ có thể dùng với model hỗ trợ gọi công cụ. Các model Claude và GPT đã thêm ở trên đều hỗ trợ.
- Thanh toán: Nạp tiền trả trước, không có phí thuê bao hàng tháng; số dư được trừ theo token. Mức nạp tối thiểu là $10, và tại trang thanh toán Stripe bạn có thể dùng thẻ (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay và Link. Nếu trang thanh toán hiển thị bằng won Hàn Quốc, KakaoPay, Naver Pay, PAYCO, Samsung Pay và các thẻ nội địa bị chặn thanh toán quốc tế cũng được cung cấp như lựa chọn (bổ sung ngày 3 tháng 10 năm 2026; hiện chưa có giao dịch nào được thanh toán bằng các phương thức này). Giá được xác định bằng đô la Mỹ, còn số tiền hiển thị bằng won do Stripe quy đổi; tỷ giá đó bao gồm phí chuyển đổi 2–4% do người thanh toán chịu. Không có Toss Pay. Hãy xem hướng dẫn thanh toán và tạo tài khoản để cấp khóa. Trang thiết lập bằng tiếng Anh là Cherry Studio integration guide.
Câu hỏi thường gặp
Cấu hình API trong Cherry Studio như thế nào?
Nhấn Settings → Model Provider → Add Provider để mở hộp thoại 'Add Custom Provider'. Nhập Provider Name và API Key, điền địa chỉ gốc vào các ô OpenAI và Anthropic trong Endpoint settings rồi lưu. Sau đó, trong danh sách model, dùng 'Sync models' để tải model và thêm model muốn sử dụng, rồi dùng 'Check' để kiểm tra một model. Nhà cung cấp phải được kích hoạt (Enable) thì model mới xuất hiện trong danh sách chọn.
Có thể dùng Cherry Studio bằng tiếng Hàn không?
Giao diện không hỗ trợ tiếng Hàn. Trong v2.1.4, 13 ngôn ngữ giao diện là tiếng Anh, tiếng Trung (giản thể và phồn thể), tiếng Nhật, tiếng Đức, tiếng Pháp, tiếng Tây Ban Nha, tiếng Bồ Đào Nha, tiếng Nga, tiếng Hy Lạp, tiếng Romania, tiếng Thổ Nhĩ Kỳ và tiếng Việt. Vì menu thường được ghi bằng tiếng Anh, trang này giữ nguyên tên menu tiếng Anh. Bản thân cuộc trò chuyện với model có thể dùng tiếng Hàn.
Có cần thêm /v1 vào địa chỉ API không?
Có thể thêm hoặc không. Theo mã nguồn v2.1.4, nếu địa chỉ gốc nhập vào chưa có phiên bản (/v1), ứng dụng sẽ tự động thêm; nếu đã có thì giữ nguyên, sau đó nối đường dẫn theo từng ô (OpenAI là /chat/completions, Anthropic là /messages). Điều cần tránh là dán URL đầy đủ đã chứa /chat/completions, vì đường dẫn sẽ bị nối hai lần và gây lỗi 404. Ký hiệu # ở cuối sẽ tắt việc tự động thêm phiên bản, nên không dùng cho endpoint tiêu chuẩn. Bạn có thể kiểm tra URL cuối trong 'Request path' bên dưới mỗi ô.
Nếu nhấn Sync models mà không thấy model thì sao?
Nút này dùng địa chỉ và khóa đã nhập để yêu cầu danh sách model của nhà cung cấp (/v1/models), nên nếu danh sách trống thì thường là vấn đề về địa chỉ hoặc khóa. Hãy kiểm tra bạn không dán URL đầy đủ và không có # ở cuối, sau đó thử chạy curl với cùng địa chỉ và khóa. Nếu nhận được JSON thì vấn đề nằm ở ứng dụng; nếu nhận 401 thì vấn đề nằm ở khóa.
Cherry Studio có miễn phí không?
Phiên bản cộng đồng dành cho máy tính để bàn là phần mềm mã nguồn mở AGPL-3.0 nên miễn phí. Khoản phải trả là phí sử dụng model của nhà cung cấp bạn đã cấu hình. Cherry Studio Enterprise là sản phẩm riêng tính theo báo giá, còn CherryAI tích hợp thì miễn phí nhưng cấu hình và giới hạn model không được công bố.
Xác nhận ngày 1 tháng 10 năm 2026: GitHub API (CherryHQ/cherry-studio, v2.1.4), danh sách tệp dịch giao diện của v2.1.4 và chuỗi giao diện tiếng Anh (en-us.json), mã nguồn màn hình thêm nhà cung cấp, tài liệu chính thức của Cherry Studio. Kunavo chưa chạy thử Cherry Studio với endpoint của mình.