Cherry Studio

Settings → Model Services → nhà cung cấp tùy chỉnh: dán key và địa chỉ API, nhấp Get Model List, toàn bộ catalog sẽ được điền vào bộ chọn.

设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)

  提供商名称 / Provider name    Kunavo
  API 密钥 / API Key            sk-kn-...
  端点设置 / Endpoint settings
    OpenAI                     https://api.kunavo.com/v1
    Anthropic                  https://api.kunavo.com
  → 同步模型 (Sync Models), then add the models you want
  → 检测 (Test) to confirm

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Mở 设置 → 模型服务 (Cài đặt → Dịch vụ mô hình) rồi chọn 添加自定义提供商 (Thêm nhà cung cấp tùy chỉnh).
3. Điền API 密钥 (khóa) và trường điểm cuối OpenAI (https://api.kunavo.com/v1).
4. Điền cả trường Anthropic (https://api.kunavo.com) — trường này nằm bên dưới OpenAI trong 端点设置 (Cài đặt điểm cuối). Cherry Agent và mọi mô hình được định tuyến qua giao thức Anthropic Messages đọc riêng từ trường này, không phải trường OpenAI. Các loại điểm cuối khác nằm trong 更多设置 (Tùy chọn khác).
5. Lưu, rồi nhấn 同步模型 trong danh sách mô hình của nhà cung cấp và thêm các mô hình trò chuyện bạn muốn; nhấn 检测 để kiểm tra một mô hình từ đầu đến cuối.
6. Gán mô hình riêng cho từng trợ lý thay vì đặt chung — Cherry Studio giữ một mô hình cho mỗi trợ lý, nhờ đó mô hình mặc định giá rẻ và mô hình chuyên dụng đắt hơn có thể cùng tồn tại.

Đã kiểm tra đối chiếu với Tài liệu về nhà cung cấp của Cherry Studio vào 1 tháng 10, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Cherry Studio.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.