Cherry Studio: chat với mọi mô hình, không cần terminal
Cherry Studio là ứng dụng chat miễn phí cho Windows, macOS và Linux, dùng được mọi nhóm trò chuyện của APIVN: Claude, GPT, Grok, Gemini, DeepSeek và China.
Cách nhanh: nhập một chạm
- Cài Cherry Studio và mở ứng dụng một lần.
- Trên apivn.vn → Khóa API, ở dòng khoá bấm ⋯ → Trò chuyện → Cherry Studio.
- Trình duyệt hỏi có mở Cherry Studio không, chọn Mở. Cherry Studio hiện hộp xác nhận nhà cung cấp new-api — tên phần mềm mã nguồn mở mà APIVN chạy trên đó, không phải bên nào khác — đồng ý.
- Trong Cherry Studio, ở nhà cung cấp vừa thêm, bấm + Add ở phần Models, nhập Model ID bất kỳ trong Mô hình (ví dụ
claude-sonnet-5), rồi ra màn hình chat chọn mô hình đó.
Thêm bằng tay
- Tải và cài từ cherry-ai.com.
- Mở Cài đặt (biểu tượng ⚙) → Model Provider → + Add. Đặt tên, chẳng hạn APIVN Claude, chọn loại OpenAI.
- Dán khoá vào ô API Key. Ô API Host điền
https://apivn.vn(ứng dụng tự nối thêm/v1). - Ở phần Models, bấm + Add và nhập Model ID bất kỳ trong Mô hình, ví dụ
claude-sonnet-5. - Bấm Check để thử khoá, bật provider, rồi ra màn hình chat chọn mô hình vừa thêm.
Gửi ảnh vào hội thoại chỉ dùng được với mô hình đọc được ảnh, ví dụ Gemini; mô hình khác sẽ báo lỗi. Nhận diện âm thanh thì chưa dùng được. Muốn tạo ảnh thì gọi API theo Tạo ảnh.
Ứng dụng khác: cần điền gì
| Trường | Giá trị |
|---|---|
| Loại nhà cung cấp | OpenAI hoặc OpenAI-compatible |
| Base URL | https://apivn.vn/v1 |
| Khoá API | Khoá APIVN dạng sk-... |
| Model | Model ID bất kỳ trong Mô hình |
Lưu xong, gửi một câu ngắn rồi xem request trong Bảng điều khiển → Nhật ký sử dụng.
Cline
Chọn API provider OpenAI Compatible, điền Base URL, khoá và model ID. Nên thử tính năng gọi công cụ (tool calling) trên một dự án nháp trước khi dùng với kho mã quan trọng.
Open WebUI
Thêm kết nối OpenAI với URL https://apivn.vn/v1 và khoá APIVN, rồi tải lại danh sách mô hình. Với khoá Tự động, gần như toàn bộ mô hình APIVN sẽ hiện ra.
OpenClaw
Điền Base URL, khoá và model ID như bảng trên. Giao diện OpenClaw đổi theo phiên bản; nếu bản bạn có không cho đổi Base URL, đừng cài bản sửa đổi không rõ nguồn.
OpenCode
OpenCode là trợ lý lập trình mã nguồn mở chạy trong terminal. Cách nhanh nhất là lệnh apivn: nó khai mỗi nhóm của bạn thành một nhà cung cấp riêng trong ~/.config/opencode/opencode.json (tên bắt đầu bằng apivn-), giữ nguyên phần cấu hình bạn đã có. Mở lại OpenCode rồi chọn mô hình có chữ APIVN · đứng đầu; các mục OpenAI/Anthropic có sẵn trong OpenCode không dùng khoá APIVN.
Tự cấu hình thì thêm một nhà cung cấp kiểu @ai-sdk/openai-compatible với baseURL là https://apivn.vn/v1 và apiKey là khoá của bạn.
Claude Desktop
Dùng được qua CC Switch bản 3.20 trở lên: thêm nhà cung cấp kiểu Custom Config, địa chỉ https://apivn.vn (không thêm /v1), dán khoá APIVN rồi bấm Enable. Các bước và video có ở Công cụ → Claude Desktop. Đừng nhập khoá APIVN vào tiện ích mở rộng không rõ nguồn gốc.