Tài liệu

Open WebUI

Open WebUI xem mọi điểm cuối tương thích OpenAI là một kết nối. Thêm kết nối trong Cài đặt quản trị viên hoặc đặt hai biến môi trường khi khởi động container — cả hai cách đều dẫn đến cùng một nơi.

Một kết nối OpenAI trong Admin Settings, hoặc OPENAI_API_BASE_URL và OPENAI_API_KEY khi khởi động container — cả hai đều kết thúc tại cùng /v1.

Kết nối hoặc docker run

# Settings → Admin Settings → Connections → Manage OpenAI API Connections → +
URL                https://api.kunavo.com/v1
API Key            sk-kn-...
Model IDs (Filter) claude-sonnet-5, claude-opus-5, claude-haiku-4-5, gpt-5-6-terra

# …or at container start, same thing:
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.kunavo.com/v1 \
  -e OPENAI_API_KEY=sk-kn-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

Điền vào Model IDs (Filter). Nếu để trống, bộ chọn sẽ liệt kê toàn bộ danh mục — bao gồm cả model hình ảnh, video và âm nhạc mà cửa sổ chat không thể gọi — khiến lần nhấp đầu tiên của người dùng có thể trúng một model như vậy. Bộ lọc này cũng hữu ích khi điểm cuối không có tuyến /models; Kunavo có tuyến này, nên dù thế nào việc xác minh cũng thành công.

URL giữ nguyên /v1. Nếu Open WebUI chạy trong Docker và bạn trỏ nó đến một dịch vụ trên cùng máy chủ, hãy thay localhost bằng host.docker.internal — điều này không áp dụng cho điểm cuối được lưu trữ, nhưng đây là lỗi người dùng thường gặp ngay sau lỗi này.

Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằng 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 Open WebUI.

Từng bước

Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
Trong Open WebUI, vào Cài đặt → Quản trị → Kết nối, rồi tìm Quản lý kết nối API OpenAI.
Nhấp ➕ Thêm kết nối rồi nhập URL và Khóa API.
Thêm các mã bạn muốn vào Model IDs (Filter), sau đó lưu và để kết nối xác minh.
Bắt đầu cuộc trò chuyện mới — các model sẽ xuất hiện trong bộ chọn với tên kết nối làm tiền tố.

Đã kiểm tra đối chiếu với Hướng dẫn về nhà cung cấp tương thích OpenAI của Open WebUI 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 Open WebUI.

# 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 Open WebUI
`claude-sonnet-5`	$1.40 / $7.00	mặc định chung cho chat
`claude-opus-5`	$3.50 / $17.50	các cuộc hội thoại phân tích dài
`claude-haiku-4-5`	$0.70 / $3.50	nhanh, rẻ và phù hợp với hầu hết các lượt trao đổi
`gpt-5-6-terra`	$0.70 / $4.20	các tài liệu dài được dán vào cửa sổ chat

Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

Câu hỏi thường gặp

Làm cách nào để kết nối Open WebUI với API tương thích OpenAI?

Vào Settings → Admin → Connections, mở "Manage OpenAI API Connections" rồi nhấp Add Connection, sau đó nhập URL điểm cuối — gốc /v1 — và khóa API. Cũng có thể thực hiện tương tự khi khởi động container bằng các biến môi trường OPENAI_API_BASE_URL và OPENAI_API_KEY. Cả hai cách đều tạo cùng một kết nối.

Model IDs (Filter) trong Open WebUI dùng để làm gì?

Trường này giới hạn những mã model từ kết nối đó xuất hiện trong bộ chọn, đồng thời là phương án dự phòng cho các điểm cuối không triển khai tuyến /models — với các điểm cuối đó, bạn thêm mã theo cách thủ công và việc xác minh sẽ thất bại dù chat vẫn hoạt động. Trên cổng có danh mục đa phương thức lớn, bạn vẫn nên đặt trường này để bộ chọn chat chỉ liệt kê những model mà cửa sổ chat thực sự có thể gọi.

URL cơ sở của Open WebUI có bao gồm /v1 không?

Có. Open WebUI chỉ nối tuyến vào URL bạn cung cấp, nên URL kết nối là gốc /v1 — https://api.example.com/v1. Các điểm cuối ví dụ trong tài liệu cũng có hậu tố này. Nếu thiếu hậu tố, kết nối vẫn được lưu nhưng mọi yêu cầu đều trả về lỗi 404.

Open WebUI có thể dùng model Claude và GPT không?

Có, nếu các model đó được cung cấp qua một điểm cuối tương thích OpenAI. Open WebUI gửi thẳng mã model đến URL kết nối, nên mã của bất kỳ nhà cung cấp nào cũng được phân giải tại điểm cuối chứ không phải trong Open WebUI. Điều đó cũng có nghĩa là một kết nối và một khóa có thể đưa mã Claude và GPT vào cùng một bộ chọn model.