Cherry Studio là ứng dụng chat miễn phí cho Windows, macOS và Linux. Một ứng dụng dùng được mọi mô hình của APIZ, tiền trừ vào một số dư. Cách gọn nhất: dùng key mặc định nhóm Tự động, một nhà cung cấp trong Cherry là gọi được mọi mô hình. Nếu bạn dùng key nhóm riêng (Claude, GPT…) để tách chi phí thì mỗi key khai thành một nhà cung cấp, như các bước dưới đây.
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. Ta chọn mô hình ở bước 6.
2. Tạo API key trên APIZ
- Đăng nhập api.apiz.vn → Khóa API → Tạo Khóa API.
- Đặt tên dễ nhớ, ô Nhóm để mặc định Tự động (gọi được mọi mô hình), hoặc chọn nhóm riêng nếu muốn tách chi phí, rồi bấm Lưu thay đổi.
- Bấm biểu tượng sao chép cạnh key. Key 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 | glm-5.3, glm-5.3-flash |
Giá từng mô hình xem ở Mô hình & giá.
3. Thêm nhà cung cấp trong Cherry
Mở Settings (biểu tượng bánh răng ở góc dưới bên trái) → Model Provider → bấm + Add Provider ở cuối danh sách nhà cung cấp.
4. Điền thông tin
| Ô | Điền |
|---|---|
| Provider Name | Tên theo nhóm key, ví dụ APIZ Gemini |
| API Key | Dán key vừa sao chép |
| OpenAI – Base URL | https://api.apiz.vn (không thêm /v1) |
| Anthropic – Base URL | Để trống |
Điền đúng thì dưới ô Base URL hiện Request path: https://api.apiz.vn/v1/chat/completions. 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 key. 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.
- Kiểm tra trang nhà cung cấp: công tắc góc phải bật (xanh), API Host là https://api.apiz.vn, danh sách có mô hình. Nút Model Check gửi một câu thử để xác nhận key.
6. Đặt mô hình mặc định (nên làm)
Settings → Default Model: chọn một mô hình của APIZ cho Default Assistant Model, Quick Model (đặt tên cuộc chat) và Translate Model. Hai ô sau nên dùng mô hình rẻ như deepseek-v4.1-flash. Để nguyên Qwen của CherryIN thì chat mới và phần dịch không đi qua APIZ.
7. Bắt đầu chat
- Bấm Chat ở thanh bên trái. Không dùng 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 APIZ. Mục dưới CherryIN là dịch vụ khác, không phải APIZ.
- 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.
Tiết kiệm: mỗi lần gửi, toàn bộ lịch sử cuộc chat được gửi lại và tính token. Đổi chủ đề thì mở cuộc chat mới (biểu tượng đầu tiên dưới ô nhập). Chi phí từng lượt xem ở Nhật ký API.
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 khác.
- 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 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 key của nhóm khác và đặt tên tương ứng: APIZ Claude, APIZ GPT, APIZ DeepSeek… Cách điền giống hệt, chỉ khác tên và key.
Không dán hai key khác nhóm vào cùng một nhà cung cấp. Cherry sẽ luân phiên dùng từng key và gọi nhầm nhóm, gây lỗi 503. Nút ⋯ → Trò chuyện → Cherry Studio trên bảng điều khiển luôn thêm key vào nhà cung cấp tên New API, nên chỉ dùng nút này cho key đầu tiên; key thứ hai trở đi thêm thủ công như trên.
Lỗi thường gặp
- 401: key sai, đã tắt hoặc hết hạn. Sao chép lại key.
- 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 key, ví dụ chọn Claude trong nhà cung cấp dùng key Gemini.
- 404: Base URL thừa /v1. Chỉ điền https://api.apiz.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 APIZ 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 được: nhắn Telegram @apiz_vn hoặc gọi 0966.68.68.66. Đừng gửi key.