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.
- Đặt tên dễ nhớ, ở ô Nhóm chọn nhóm mô hình định dùng, bấm Lưu thay đổi.
- 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.
| Nhóm key | Mô hình dùng được (ví dụ) |
|---|---|
| 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 |
| China | kimi-k3, glm-5.3 |
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 | Đặt theo nhóm khoá, ví dụ APIVN Gemini |
| 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 của nhóm khoá. 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.
Thêm nhóm mô hình khác
Làm lại bước 2 đến 5 với khoá của nhóm khác và đặt tên tương ứng: APIVN Claude, APIVN GPT, APIVN DeepSeek… Cách điền giống hệt, chỉ khác tên và khoá.
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: mô hình không thuộc nhóm của khoá, ví dụ chọn Claude trong nhà cung cấp dùng khoá Gemini.
- 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á.