Tài liệu
Chatbox
Chatbox tách điểm cuối thành máy chủ và đường dẫn, rồi tự điền đường dẫn cho bạn. Vì vậy, máy chủ phải là nguồn gốc — thêm /v1 vào đó là lỗi mà ứng dụng này dễ khiến người dùng mắc phải nhất.
Thêm nhà cung cấp loại OpenAI API Compatible với API Host đặt tại service root — Chatbox tự thêm /v1/chat/completions.
Settings → Model Providers → Add
API 提供方名称 / Provider name Kunavo
API 类型 / Type OpenAI API 兼容 (OpenAI API compatible)
API 密钥 / API Key sk-kn-...
API 主机 / API Host https://api.kunavo.com
API 路径 / API Path (leave empty → /v1/chat/completions)
Model claude-sonnet-5https://api.kunavo.com, không có /v1. Chatbox có trường API Path riêng, mặc định là /v1/chat/completions, vì vậy nếu máy chủ đã kết thúc bằng /v1 thì yêu cầu sẽ được gửi đến /v1/v1/chat/completions. Để trống đường dẫn trừ khi bạn biết mình cần giá trị khác.sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Chatbox.Từng bước
- Tạo khóa tại
/app/keysrồi sao chép khóa — khóa chỉ hiển thị một lần. - Mở Cài đặt → Nhà cung cấp mô hình rồi nhấp Thêm.
- Đặt tên cho nhà cung cấp, đặt loại thành Tương thích OpenAI API rồi dán Khóa API.
- Đặt API 主机 / API Host thành
https://api.kunavo.comvà để trống API 路径 / API Path. - Thêm các ID mô hình bạn muốn, lưu lại rồi bắt đầu cuộc trò chuyện.
Đã kiểm tra đối chiếu với Hướng dẫn cấu hình nhà cung cấp của Chatbox vào 6 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.
Xác minh trước khi gỡ lỗi ứng dụng khách
Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Chatbox.
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."Đặt model id nào vào trường
Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.
| ID mô hình | Kunavo vào / ra | Phù hợp ở đâu trong Chatbox |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | mô hình mặc định cho cuộc trò chuyện |
claude-haiku-4-5 | $0.70 / $3.50 | các cuộc trao đổi ngắn, nơi độ trễ và giá cả đều quan trọng |
claude-opus-5 | $3.50 / $17.50 | một mục nhà cung cấp thứ hai dành cho những câu hỏi khó |
gpt-5-6-terra | $0.70 / $4.20 | một họ mô hình khác dùng cùng khóa |
Câu hỏi thường gặp
API Host của Chatbox nên là gì khi dùng điểm cuối tương thích OpenAI?
Nguồn gốc, không có đường dẫn — ví dụ https://api.example.com. Chatbox có trường API Path riêng, mặc định là /v1/chat/completions; theo tài liệu, trường này thường không cần điền, vì vậy /v1 thuộc đường dẫn chứ không phải máy chủ. Nếu máy chủ kết thúc bằng /v1, yêu cầu sẽ đến /v1/v1/chat/completions và trả về lỗi 404.
Làm cách nào để thêm nhà cung cấp mô hình tùy chỉnh trong Chatbox?
Mở Cài đặt → Nhà cung cấp mô hình rồi nhấp Thêm; tiếp đó đặt tên nhà cung cấp, chọn loại API tương thích OpenAI, dán khóa API, đặt API Host thành nguồn gốc của điểm cuối và để trống API Path. Thêm các ID mô hình bạn muốn dùng rồi lưu; nhà cung cấp sẽ xuất hiện trong bộ chọn mô hình ở mọi cuộc trò chuyện.
Chatbox có thể giao tiếp với các mô hình Claude không?
Có, thông qua điểm cuối tương thích OpenAI cung cấp các mô hình đó. Chatbox gửi ID mô hình bạn nhập đến máy chủ đã cấu hình, nên ID Claude được phân giải tại đó chứ không phải trong Chatbox; ứng dụng không cần thông tin xác thực Anthropic riêng. Bộ chọn loại nhà cung cấp chọn định dạng giao tiếp, không chọn hãng.
Khi nào tôi nên điền API Path của Chatbox?
Chỉ khi điểm cuối không cung cấp chat completions tại /v1/chat/completions. Trường này dành cho các cổng có định tuyến khác thường; với dịch vụ tương thích OpenAI tiêu chuẩn, để trống là đúng. Nhập đường dẫn vào đây thường gây lỗi 404 trông giống như vấn đề xác thực.