Cài đặt API Cherry Studio — nhà cung cấp, địa chỉ và khóa

Để thiết lập API riêng trong Cherry Studio, vào 設定 → 模型供應商 → 新增供應商: nhập API key, điền một địa chỉ gốc vào mỗi trường OpenAI và Anthropic trong “端點設定”, lưu, nhấn “同步模型” để tải model vào, rồi dùng “檢查” để xác nhận.Bài viết này dựa trên v2.1.4 phát hành ngày 30 tháng 9 năm 2026; tất cả tên menu được viết nguyên văn theo giao diện tiếng Hoa phồn thể của Cherry Studio. v2 đã thay đổi lớn màn hình thêm nhà cung cấp, nên hướng dẫn thời v1 “類型選 OpenAI” không còn khớp với giao diện.

Trang này đề cập đến bản desktop của CherryHQ/cherry-studio (AGPL-3.0, hỗ trợ Windows, macOS, Linux). Khi kiểm tra ngày 1 tháng 10 năm 2026, kho mã chưa bị 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à sản phẩm không liên quan của nhà phát triển khác. Ngoài ra, tài liệu chính thức của Cherry Studio bằng tiếng Hoa giản thể; khi chuyển giao diện sang phồn thể, “提供商／服務商” sẽ hiển thị là “供應商”, vì vậy đừng để tên gọi gây nhầm lẫn khi đối chiếu tài liệu.

Thiết lập từng bước

Cherry Studio v2.1.4 (giao diện tiếng Hoa phồn thể)

設定 → 模型供應商 → 新增供應商
  （對話框標題：新增自訂供應商）

  供應商名稱                 Kunavo
  API 金鑰                   sk-kn-...
  端點設定
    OpenAI Chat Completions  https://api.kunavo.com/v1
    Anthropic Messages       https://api.kunavo.com
  更多選項
    OpenAI Responses         https://api.kunavo.com/v1   （選填）
    影像產生基礎 URL           https://api.kunavo.com/v1   （選填）
    Google Gemini            留空

→ 儲存 → 在模型清單按「同步模型」→ 加入要用的模型 → 「檢查」

Mở Cài đặt → Nhà cung cấp model, nhấn Thêm nhà cung cấp. Hộp thoại bật lên có tiêu đề “Thêm nhà cung cấp tùy chỉnh”. Với dịch vụ dạng Coding Plan, nhiều tài khoản hoặc cần tách theo dự án, bạn có thể dùng “Bắt đầu từ mặc định (tùy chọn)” ở phía trên để tạo từ cấu hình mặc định hiện có.
Điền Tên nhà cung cấp và API key.
Cài đặt endpoint mặc định có sẵn hai trường OpenAI Chat Completions và Anthropic Messages; ít nhất phải cấu hình một endpoint văn bản. Điền cả hai để các Agent ngoài trò chuyện và tính năng dùng định dạng Anthropic cũng có thể chọn model.
Mở rộng Tùy chọn khác; còn có OpenAI Responses, Google Gemini, URL cơ sở tạo ảnh và URL cơ sở chỉnh sửa ảnh. Để trống những mục không dùng.
Sau khi lưu, xác nhận nhà cung cấp này đang ở trạng thái bật. Tài liệu chính thức cho biết nhà cung cấp đã cấu hình nhưng chưa bật sẽ không hiển thị model trong menu — đây là nguyên nhân phổ biến nhất khiến “khóa không có tác dụng”.
Trong danh sách model, nhấn Đồng bộ model, thêm model muốn dùng, rồi nhấn Kiểm tra để thử một model.

Cách điền địa chỉ: chỉ điền địa chỉ gốc

Theo mã nguồn v2.1.4, mỗi trường nhận địa chỉ gốc: nếu không có đoạn phiên bản thì hệ thống tự động thêm /v1 (đã có thì không thêm), rồi nối đường dẫn cố định của trường đó. Bên dưới mỗi trường đều hiển thị “Đường dẫn yêu cầu”, chính là URL cuối cùng được gửi đi.

Trường	Đường dẫn Cherry Studio nối vào	Kunavo
OpenAI Chat Completions	`/chat/completions`	Hỗ trợ
Anthropic Messages	`/messages`	Hỗ trợ
OpenAI Responses (Tùy chọn khác)	`/responses`	Hỗ trợ
URL cơ sở tạo ảnh (Tùy chọn khác)	`/images/generations`	Hỗ trợ
URL cơ sở chỉnh sửa ảnh (Tùy chọn khác)	`/images/edits`	Hỗ trợ
Google Gemini (Tùy chọn khác)	`/models/{model}:generateContent`	Không hỗ trợ, để trống

Hai lỗi thường gặp: một là dán URL đầy đủ có /chat/completions hoặc /messages, khiến đường dẫn bị lặp và trả về 404; hai là thêm # ở cuối. Gợi ý trên giao diện ghi rất rõ: “Thêm # ở cuối để tắt việc tự động thêm phiên bản API.” Khi thêm vào endpoint chuẩn, /v1 sẽ biến mất.

Thiết lập thuận tay, giảm đáng kể hóa đơn

Ngoài trò chuyện, Cherry Studio còn gọi model ở phía sau. Model nhanh theo mô tả giao diện là “model dùng cho các tác vụ đơn giản như đặt tên cuộc trò chuyện và rút trích từ khóa tìm kiếm”; gợi ý cũng ghi “hãy chọn model nhẹ và tránh dùng model suy luận”. Đặt một model rẻ ở đây để không phải cho model đắt chạy một lượt trong mọi cuộc trò chuyện. Model dịch cũng được cấu hình riêng. Nếu đặt câu hỏi cho nhiều model cùng lúc, mỗi model sẽ nhận một yêu cầu và được tính phí một lần. Số tiền trong thống kê sử dụng của ứng dụng là giá trị ước tính quy đổi theo giá công khai, nên sẽ cao hơn khi dùng tuyến có chiết khấu; sửa đơn giá trong phần cài đặt model thành giá thực tế của bạn sẽ cho kết quả chính xác. Xem thêm Chi phí API của Cherry Studio bằng tiếng Anh.

Lưu ý khi dùng Kunavo và thanh toán tại Đài Loan

Phạm vi xác minh: Các thiết lập trên được tổng hợp từ mã nguồn và tài liệu chính thức của Cherry Studio; Kunavo chưa thực sự kết nối Cherry Studio với endpoint riêng để chạy thử. Hãy giữ lại tuyến hiện đang hoạt động rồi thử tuyến này.
Chỉ trò chuyện và hình ảnh: Kunavo không có model embedding; việc truy xuất vector của kho kiến thức cần dùng nhà cung cấp khác hoặc model embedding cục bộ. Tài liệu chính thức cho biết khi không có model embedding, kho kiến thức vẫn hoạt động bằng truy xuất từ khóa BM25.
Công cụ MCP: Các công cụ được thêm tại Cài đặt → Máy chủ MCP chỉ có thể được gọi bằng model hỗ trợ gọi công cụ; các model Claude và GPT được thêm ở trên đều hỗ trợ.
Thanh toán: Nạp tiền trả trước, khấu trừ theo token, không có phí hằng tháng. Mức nạp tối thiểu là $10, thanh toán qua Stripe; tại Đài Loan có thể dùng thẻ tín dụng (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay và Link; JKO Pay và LINE Pay không có trong danh sách được hỗ trợ. Xem tài liệu thanh toán; sau khi chuẩn bị xong, bạn có thể tạo tài khoản và tạo khóa. Trang cài đặt bằng tiếng Anh là hướng dẫn tích hợp Cherry Studio.

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

Thiết lập API riêng trong Cherry Studio như thế nào?

Vào Cài đặt → Nhà cung cấp model → Thêm nhà cung cấp, mở hộp thoại “Thêm nhà cung cấp tùy chỉnh”, điền tên nhà cung cấp và API key, rồi điền địa chỉ gốc vào các trường OpenAI Chat Completions và Anthropic Messages trong phần cài đặt endpoint trước khi lưu. Tiếp theo, nhấn “Đồng bộ model” trong danh sách model để tải model vào, thêm model muốn dùng, rồi dùng “Kiểm tra” để xác nhận một model hoạt động. Nhà cung cấp phải ở trạng thái bật, nếu không model sẽ không xuất hiện trong menu.

Địa chỉ API của Cherry Studio có cần thêm /v1 không?

Có hoặc không đều được. Mã nguồn v2.1.4 sẽ tự động thêm phiên bản (/v1) vào sau địa chỉ gốc bạn nhập; nếu đã có thì không thêm lần nữa, sau đó nối đường dẫn riêng của trường đó (OpenAI là /chat/completions, Anthropic là /messages). Điều cần tránh là dán URL đầy đủ có chứa /chat/completions, vì đường dẫn sẽ bị lặp và trả về 404. Dấu # ở cuối dùng để “tắt việc tự động thêm phiên bản API”; không thêm dấu này vào endpoint chuẩn. Bên dưới mỗi trường sẽ hiển thị “Đường dẫn yêu cầu”, chỉ cần xem qua trước khi lưu là biết URL cuối cùng.

Nếu “Đồng bộ model” không tải được model nào thì sao?

Nút này dùng địa chỉ và khóa bạn điền để yêu cầu danh sách model của nhà cung cấp (/v1/models). Nếu danh sách trống thì phần lớn là vấn đề về địa chỉ hoặc khóa, không phải Cherry Studio. Trước hết hãy xác nhận bạn không dán URL đầy đủ và không có dấu # ở cuối, sau đó dùng curl để kiểm tra cùng địa chỉ và khóa: trả về JSON nghĩa là vấn đề nằm trong ứng dụng, còn 401 nghĩa là khóa không đúng.

Cherry Studio có thể chuyển sang tiếng Hoa phồn thể không?

Có. Giao diện Cherry Studio tích hợp 13 ngôn ngữ, bao gồm tiếng Hoa phồn thể (zh-TW), có thể chuyển trong tùy chọn ngôn ngữ của phần cài đặt. Lưu ý rằng giao diện phồn thể gọi nhà cung cấp dịch vụ là “供應商”, còn tài liệu chính thức và giao diện giản thể dùng “提供商” hoặc “服務商”; tên gọi khác nhau khi đối chiếu hướng dẫn nhưng đều chỉ cùng một thứ.

Cherry Studio có mất phí không?

Bản desktop (bản cộng đồng) là phần mềm nguồn mở AGPL-3.0 và 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 thương mại báo giá riêng; CherryAI tích hợp sẵn miễn phí, nhưng danh mục model và hạn mức chưa được công bố.

Xác minh ngày 1 tháng 10 năm 2026: GitHub API (CherryHQ/cherry-studio, v2.1.4), chuỗi giao diện tiếng Hoa phồn thể của v2.1.4 (zh-tw.json), mã nguồn màn hình thêm nhà cung cấp và tài liệu chính thức của Cherry Studio. Kunavo chưa thực sự chạy endpoint riêng qua Cherry Studio.