1. Cài Cherry Studio
- Tải và cài từ cherry-ai.com.
- Lần đầu mở, Cherry hiện màn hình Choose Default Model: bấm Set up later ở góc phải trên. Mô hình sẽ chọn ở bước 6.
2. Tạo khoá API trên APIVN
- Đăng nhập apivn.vn → Khóa API → Tạo Khóa API.
- Hoặc bỏ qua hẳn bước tạo: khoá sẵn có sau khi đăng ký đã dùng được. Cần khoá riêng cho Cherry thì đặt tên rồi Lưu thay đổi, ô Nhóm để nguyên Tự động.
- Bấm biểu tượng sao chép cạnh khoá. Khoá chỉ dán vào Cherry, không gửi cho ai.
| Hãng | Vài mô hình để bắt đầu |
|---|---|
| Claude | claude-sonnet-5, claude-opus-5, claude-haiku-4-5 |
| GPT | gpt-5.6-sol, gpt-5.6-terra, gpt-6-astra |
| Gemini | gemini-3.8-flash, gemini-3.1-pro-preview |
| DeepSeek | deepseek-v4.1-flash, deepseek-v4-pro |
| Grok | grok-4.6 |
Giá từng mô hình xem ở Mô hình.
3. Thêm nhà cung cấp trong Cherry
Mở Settings (bánh răng ở góc dưới bên trái) → Model Provider → bấm + Add Provider ở cuối danh sách.
4. Điền thông tin
| Ô | Điền |
|---|---|
| Provider Name | APIVN |
| API Key | Dán khoá vừa sao chép |
| OpenAI – Base URL | https://apivn.vn (không thêm /v1) |
| Anthropic – Base URL | Để trống |
Điền đúng thì dưới ô Base URL hiện Request path: https://apivn.vn/v1/chat/completions. Bấm Add.
https://apivn.vn; thấy dòng Request path là đúng. Bấm Add.5. Chọn mô hình và kiểm tra
- Cherry tự tải danh sách mô hình khoá của bạn gọi được — cả Claude, GPT, Gemini, Grok lẫn DeepSeek. Tick hoặc bấm + ở mô hình muốn dùng, rồi Add selected models → Verify and enable.
- Không thấy danh sách: mở lại nhà cung cấp, bấm Sync models.
- Soát trang nhà cung cấp: công tắc góc phải bật (xanh), API Host là
https://apivn.vn, danh sách có mô hình. Nút Model Check gửi một câu thử để xác nhận khoá.
6. Đặt mô hình mặc định (nên làm)
Settings → Default Model: chọn một mô hình của APIVN cho Default Assistant Model, Quick Model (đặt tên cuộc chat) và Translate Model. Hai ô sau nên chọn mô hình rẻ như deepseek-v4.1-flash. Để nguyên Qwen của CherryIN thì chat mới và phần dịch sẽ không đi qua APIVN.
7. Bắt đầu chat
- Bấm Chat ở thanh bên trái. Đừng vào Work: đó là chế độ Agent, gửi tin ở đó Cherry sẽ đòi bật API Gateway.
- Bấm tên mô hình ở thanh trên, gõ để lọc (ví dụ
gemini) và chọn mục nằm dưới tên nhà cung cấp APIVN. Mục dưới CherryIN là dịch vụ khác, không phải APIVN. - Gõ câu hỏi, Enter để gửi, Shift + Enter để xuống dòng. Đổi mô hình giữa chừng ngay trong cùng cuộc chat được.
Mẹo dùng
- Hỏi lại bằng mô hình khác: bấm @ dưới câu trả lời và chọn mô hình.
- So sánh hai mô hình: ở bộ chọn mô hình bấm Multi-select, chọn hai mô hình rồi gửi một câu (tính tiền cả hai).
- Đính kèm file, ảnh: nút + dưới ô nhập. Ảnh chụp màn hình thì dùng mô hình Gemini; DeepSeek không đọc ảnh.
- Dịch: mục Translation ở thanh trái, dùng Translate Model đã đặt ở bước 6.
- Trợ lý dùng lại: Add Assistant, viết lời nhắc cố định (ví dụ “dịch mọi tin nhắn sang tiếng Việt”) và chọn mô hình riêng.
Khi nào cần nhà cung cấp thứ hai
Gần như không bao giờ. Một nhà cung cấp với một khoá đã gọi được mọi mô hình, muốn thêm mô hình thì quay lại bước 5 và tick thêm — không phải tạo khoá mới, không phải thêm nhà cung cấp mới.
Lỗi thường gặp
- 401: khoá sai, đã tắt hoặc hết hạn. Chép lại khoá.
- 403: hết số dư. Xem Nạp tiền.
- 503 hoặc model_not_found: gõ nhầm Model ID, hoặc nhà cung cấp trong Cherry đang dùng một khoá bị gắn nhóm cụ thể. Khoá Tự động gọi được mọi mô hình, nên gần như không gặp lỗi này.
- 404: Base URL thừa
/v1. Chỉ điềnhttps://apivn.vn. - Cherry hỏi “Enable the API Gateway?”: bạn đang ở chế độ Work. Bấm Cancel và chuyển sang Chat.
- Không thấy mô hình APIVN khi chat: công tắc nhà cung cấp chưa bật, hoặc chưa thêm mô hình ở bước 5.
Vẫn chưa xong: liên hệ APIVN qua trang Liên hệ. Đừng gửi khoá.