Tài liệu
LobeChat
Để LobeChat tự lưu trữ có thể kết nối với Kunavo, cần ba biến môi trường: khóa, URL proxy và danh sách model id muốn hiển thị trong danh sách chọn.
Đặt OPENAI_API_KEY thành khóa sk-kn-… của bạn, OPENAI_PROXY_URL thành https://api.kunavo.com/v1, rồi khai báo các id bạn muốn trong OPENAI_MODEL_LIST. Khi đó, Claude và GPT sẽ cùng xuất hiện trong một danh sách chọn và dùng chung một số dư.
OPENAI_API_KEY=sk-kn-...
OPENAI_PROXY_URL=https://api.kunavo.com/v1
# LobeChat only shows models it knows about, so name the ones you want.
OPENAI_MODEL_LIST=claude-sonnet-5,claude-haiku-4-5,claude-opus-5,gpt-5-6-terra/v1 phải nằm trong OPENAI_PROXY_URL. LobeChat chuyển tiếp đến URL bạn cung cấp thay vì tự dựng lại đường dẫn OpenAI. Vì vậy, tài liệu của LobeChat ghi giá trị mặc định là https://api.openai.com/v1 trong .env.example — bao gồm cả hậu tố.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. - Thêm ba biến này vào môi trường của bản triển khai: dùng tệp
.envcho bản cài đặt độc lập hoặc khốienvironmentcho Docker. - Khởi động lại container để hệ thống nhận môi trường mới.
- Mở LobeChat, bắt đầu một phiên và chọn một trong các id bạn đã liệt kê trong
OPENAI_MODEL_LIST.
services:
lobe-chat:
image: lobehub/lobe-chat
ports:
- "3210:3210"
environment:
OPENAI_API_KEY: sk-kn-...
OPENAI_PROXY_URL: https://api.kunavo.com/v1
OPENAI_MODEL_LIST: claude-sonnet-5,claude-haiku-4-5,gpt-5-6-terraTài liệu tham khảo của LobeChat về các biến này nằm trên trang biến môi trường cho nhà cung cấp mô hình.
Xác minh trước khi gỡ lỗi container
Chỉ với một yêu cầu, bạn có thể xác định lỗi nằm ở endpoint, khóa hay danh sách mô hình của LobeChat. Nếu yêu cầu này trả về danh sách model id dạng JSON, URL và khóa đó hoạt động — khi ấy, nếu danh sách chọn trống thì nguyên nhân là OPENAI_MODEL_LIST, không phải endpoint.
# Settles whether a failure is the endpoint, the key, or LobeChat.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."Các id cần liệt kê
Bạn có thể đưa mọi mô hình văn bản trên Kunavo vào OPENAI_MODEL_LIST — danh sách đầy đủ có trên trang mô hình và được cập nhật trực tiếp từ GET /v1/models. Mức giá tính bằng USD cho mỗi 1M token, đầu vào / đầu ra.
| ID mô hình | Kunavo vào / ra | Phù hợp ở đâu |
|---|---|---|
claude-haiku-4-5 | $0.70 / $3.50 | Claude rẻ nhất — dành cho các phiên chat dài khi chi phí mỗi lượt là điều đáng cân nhắc |
claude-sonnet-5 | $1.40 / $7.00 | Cân bằng mặc định giữa chất lượng và giá |
claude-opus-5 | $3.50 / $17.50 | Cấp Claude có chất lượng cao nhất |
gpt-5-6-terra | $0.70 / $4.20 | Cùng một khóa, khác họ mô hình — không cần cấu hình nhà cung cấp thứ hai |
Câu hỏi thường gặp
Làm cách nào để trỏ LobeChat đến endpoint tương thích OpenAI tùy chỉnh?
Đặt OPENAI_PROXY_URL thành URL cơ sở của endpoint và OPENAI_API_KEY thành khóa của bạn trong môi trường triển khai — với Kunavo, giá trị đó là https://api.kunavo.com/v1. Tệp .env.example của chính LobeChat dùng https://api.openai.com/v1 làm giá trị ví dụ cho biến đó; điều này nhắc rằng hậu tố /v1 phải nằm trong giá trị, không được tự thêm vào sau.
Tại sao mô hình tùy chỉnh của tôi không xuất hiện trong danh sách mô hình của LobeChat?
LobeChat hiển thị các mô hình đã được khai báo với ứng dụng, chứ không phải mọi mô hình mà endpoint có thể cung cấp. Vì vậy, một model id không có trong danh sách sẽ không hiển thị, ngay cả khi endpoint phản hồi được với id đó. Hãy khai báo các id trong OPENAI_MODEL_LIST dưới dạng danh sách phân tách bằng dấu phẩy. Tài liệu của LobeChat cũng quy định cú pháp tiền tố cho biến này: dấu + ở đầu để thêm mô hình, dấu - ở đầu để ẩn mô hình, còn model_name=display_name để đổi tên mô hình trong danh sách chọn.
LobeChat có thể dùng các mô hình Claude thông qua nhà cung cấp OpenAI không?
Có, nếu chúng được cung cấp qua endpoint tương thích với OpenAI. Nhà cung cấp OpenAI của LobeChat gửi model id đến địa chỉ được chỉ định trong OPENAI_PROXY_URL, nên id Claude được phân giải tại gateway chứ không phải bên trong LobeChat, và không cần thông tin xác thực Anthropic. Trên Kunavo, các id Claude và GPT dùng chung một khóa, vì vậy để thêm một họ mô hình, bạn chỉ cần thêm id vào OPENAI_MODEL_LIST.
Tính năng tạo ảnh của LobeChat có hoạt động qua endpoint tùy chỉnh không?
Điều đó phụ thuộc vào các route mà endpoint triển khai, chứ không phụ thuộc vào LobeChat. Nhà cung cấp chat cần /v1/chat/completions; tạo ảnh là một route riêng. Kunavo triển khai tính năng tạo ảnh và video trên các endpoint riêng, được mô tả trong tài liệu về images và video. Vì vậy, cách đáng tin cậy là dùng LobeChat để chat và gọi trực tiếp các endpoint đa phương tiện, thay vì cho rằng một thiết lập nhà cung cấp có thể xử lý cả hai.