Chatbox
Thêm provider tương thích OpenAI trong Chatbox
Chatbox hỗ trợ provider tùy chỉnh cho Chat Completions, Responses và Claude. Bắt đầu với key và model của hệ thống.
1. Cài Chatbox
Tải bản desktop từ chatboxai.app, cài và mở ứng dụng. Bản desktop phù hợp để cấu hình API trực tiếp; bản web còn phụ thuộc CORS của gateway.
2. Thêm provider
Mở Settings → Model Provider, chọn Add provider:
| Trường | Giá trị |
|---|---|
| Name | VNAI Pro |
| API Mode | OpenAI API Compatible |
Bấm Add, rồi cấu hình provider vừa tạo:
| Trường | Giá trị |
|---|---|
| API Key | Key được tạo trên website của hệ thống |
| API Host | https://api.vnaipro.app/v1 |
| API Path | /chat/completions |
| Model ID | ID từ Kiểm tra model |
Dòng Preview phải là https://api.vnaipro.app/v1/chat/completions.
Không điền /v1/chat/completions vào API Path khi API Host đã có /v1.
3. Chọn model và thử
Thêm model ID vào danh sách model của provider nếu chưa có, lưu cấu hình. Tạo hội thoại mới, chọn provider VNAI Pro và model vừa thêm, gửi câu hỏi ngắn. Kiểm tra lịch sử sử dụng trên website.
Model dùng giao thức khác
| Model/kênh | API Mode | API Host | API Path |
|---|---|---|---|
| Responses | OpenAI Responses API Compatible | https://api.vnaipro.app/v1 | /responses |
| Claude native | Claude API Compatible | https://api.vnaipro.app/v1 | /messages |
Tạo provider riêng cho mỗi giao thức. Trong Chatbox, adapter Claude ghép /messages vào API Host,
nên Host có /v1; đây là khác biệt với cấu hình Claude Code dùng URL gốc.
Nếu phiên bản chưa có chế độ Responses, cập nhật hoặc chọn model Chat Completions.
Chat hoạt động nhưng knowledge base lỗi: embedding là cấu hình riêng; key/model chat không tự cung cấp embedding. Lỗi kết nối: kiểm tra dòng Preview và lỗi chung.
Nguồn: Chatbox, API modes trong giao diện, Quy tắc ghép URL.