Chuyển tới nội dung chính

Cherry Studio

Cherry Studio kết nối qua Provider OpenAI compatible với Base URL /v1.

Trước khi cấu hình​

  • Trang này chỉ dùng placeholder. Key thật lấy từ trang PopGo API keys, mô hình lấy từ models and pricing.
  • Cấu hình một click dành cho phần mềm đã cài và đã đăng ký protocol handler. Khi trình duyệt hỏi mở ứng dụng ngoài, hãy cho phép.
  • Khi cấu hình thủ công, lưu một Provider tối thiểu trước. Chỉ bật streaming, tools hoặc định tuyến nhiều mô hình sau khi yêu cầu đầu tiên thành công.

Nguồn chính thức và xác minh​

Cherry Studio 1.9.12 đã được đối chiếu với nguồn chính thức vào 2026-07-13. Nguồn chính thức. Phạm vi xác minh là cấu hình Provider tùy chỉnh trong Cherry Studio.

Cấu hình một lần chạm​

Đăng nhập trang khóa PopGo API rồi mở menu thao tác tại hàng Key cần dùng. Tài liệu công khai không tạo hoặc hiển thị liên kết chứa Key. Mở menu con Chat rồi chọn Cherry Studio. Sau khi nhập, xác nhận OpenAI compatible và chọn mô hình đang khả dụng.

Cấu hình thủ công​

Chọn Provider OpenAI compatible rồi điền các trường bên dưới.

TrườngGiá trị
Loại ProviderOpenAI compatible
Base URLhttps://api.popgo.site/v1
API KeyYOUR_API_KEY
ModelYOUR_MODEL

Quy trình cấu hình bằng văn bản​

  1. Cài hoặc cập nhật Cherry Studio lên phiên bản hiện tại, rồi mở “Cài đặt → Dịch vụ mô hình”.
  2. Tạo Provider tùy chỉnh và chọn OpenAI compatible. Không sửa Provider chính thức tích hợp sẵn.
  3. Nhập https://api.popgo.site/v1 vào Base URL, YOUR_API_KEY vào API Key và YOUR_MODEL vào Model.
  4. Lưu, tạo hội thoại mới và gửi tin nhắn ngắn trước. Chỉ bật hình ảnh, video, tools hoặc ngữ cảnh dài sau khi thành công.
  5. Tạo Provider riêng cho các giao thức hoặc nhóm mô hình khác nhau để không trộn địa chỉ.

Hiện tượng cấu hình thường gặp​

  • Danh sách mô hình trống không nhất thiết là kết nối lỗi. Nếu ứng dụng không lấy mô hình bên thứ ba, hãy nhập thủ công YOUR_MODEL.
  • Nếu vẫn gọi dịch vụ mặc định sau khi lưu, chọn Provider mới, đóng hội thoại cũ và khởi động lại ứng dụng.
  • Nếu phiên bản cũ không có tính năng mới, hãy cập nhật và làm theo các trường của giao diện hiện tại.

Kiểm tra thành công​

Gửi tin nhắn ngắn từ phần thử mô hình hoặc hội thoại mới; nội dung trả về xác nhận thành công.

Lỗi thường gặp và cách khôi phục​

  • Nếu thử kết nối lỗi, kiểm tra /v1 không bị lặp ở cuối Base URL.
  • Với 401, dán lại YOUR_API_KEY và bỏ khoảng trắng ở hai đầu.
  • Với 404, kiểm tra cấp Base URL và bảo đảm ứng dụng không nối /v1 hai lần.