Tới nội dung

Tài liệu APIVN

Cherry Studio, Cline và ứng dụng khác

Cherry Studio để chat với mọi mô hình APIVN mà không cần terminal. Ứng dụng nào cho thêm nhà cung cấp tương thích OpenAI đều dùng được APIVN.

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 của APIVN: Claude, GPT, Grok, Gemini, DeepSeek và China (Kimi, GLM).

Cách nhanh: nhập một chạm

  1. Cài Cherry Studio và mở ứng dụng một lần.
  2. Trên apivn.vnKhóa API, ở dòng khoá bấm ⋯ → Trò chuyện → Cherry Studio.
  3. 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, đồng ý.
  4. Trong Cherry Studio, ở nhà cung cấp vừa thêm, bấm + Add ở phần Models, nhập Model ID thuộc nhóm của khoá (ví dụ claude-sonnet-5), rồi ra màn hình chat chọn mô hình đó.
Menu ba chấm ở dòng khoá: CC Switch, và Trò chuyện → Cherry Studio
Menu ở dòng khoá: CC Switch cho Codex hoặc Claude Code, Trò chuyện → Cherry Studio để chat.

Thêm bằng tay

  1. Tải và cài từ cherry-ai.com.
  2. 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.
  3. Dán khoá vào ô API Key. Ô API Host điền https://apivn.vn (ứng dụng tự nối thêm /v1).
  4. Ở phần Models, bấm + Add và nhập Model ID thuộc nhóm của khoá, ví dụ claude-sonnet-5.
  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.

Đừng bật nhận diện ảnh hay âm thanh trong ứng dụng vì APIVN chưa hỗ trợ chính thứ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ườngGiá trị
Loại nhà cung cấpOpenAI hoặc OpenAI-compatible
Base URLhttps://apivn.vn/v1
Khoá APIKhoá APIVN dạng sk-...
ModelModel ID trong Mô hình, thuộc nhóm của khoá

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ý API.

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. Chỉ mô hình thuộc nhóm của khoá mới 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.

Claude Desktop

Chưa dùng được: ứng dụng Claude Desktop không cho đổi địa chỉ API. Muốn chat với Claude thì dùng Cherry Studio; muốn lập trình thì dùng Claude Code + CC Switch. Đừng nhập khoá APIVN vào tiện ích mở rộng không rõ nguồn gốc.