Cài đặt Open WebUI API

Thêm TokenHub vào Open WebUI dưới dạng kết nối OpenAI-compatible, chọn một mô hình và xác minh yêu cầu trò chuyện.

Tạo TokenHub API Key

Open WebUI là gì?

Open WebUI là giao diện tự lưu trữ để trò chuyện với các mô hình AI và kết nối các nhà cung cấp mô hình OpenAI-compatible.

Thiết lập Open WebUI này thêm TokenHub từ bảng kết nối quản trị viên. Nó sử dụng giao thức OpenAI Chat Completions và cung cấp danh sách cho phép mô hình thủ công khi nhà cung cấp không hiển thị /model. Kết nối thuộc bảng kết nối quản trị viên, trong đó một nhà cung cấp OpenAI-compatible có thể hiển thị một hoặc nhiều mô hình cho người dùng. Khi tính năng tự động phát hiện mô hình không khả dụng, hãy sử dụng danh sách cho phép mô hình thay vì cho rằng điểm cuối trò chuyện bị hỏng và kiểm tra quyền truy cập mạng từ bên trong vùng chứa Open WebUI khi tự lưu trữ bằng Docker.

Open WebUI quản lý các dịch vụ mô hình theo giao thức thay vì yêu cầu một trình cắm riêng cho mỗi nhà cung cấp. Thêm TokenHub làm OpenAI API Connection. Open WebUI sau đó gắn /models và /chat/completions vào cơ sở API URL.

Thêm TokenHub trong Kết nối quản trị viên

Điều này tuân theo trình tự Step 1: Add Your Provider Connection chính thức của Open WebUI:

  1. Đăng nhập vào Open WebUI bằng tài khoản quản trị viên.
  2. Đi tới Settings → Admin → Connections.
  3. Tìm Manage OpenAI API Connections và nhấp vào Add Connection (nút dấu cộng).
  4. Nhập https://us-api.tokenhub.com/v1 vào URL.
  5. Nhập khóa TokenHub API của bạn vào API Key.
  6. Nếu xác minh kết nối không trả về bất kỳ mẫu nào, hãy nhập ID mẫu TokenHub chính xác trong Model IDs (Filter) và nhấp vào nút dấu cộng để thêm mẫu đó vào danh sách cho phép.
  7. Nhấp vào Save.

Không đặt /chat/completions vào URL. Open WebUI tự nối thêm các đường dẫn yêu cầu, do đó, yêu cầu đầy đủ URL sẽ tạo ra một đường dẫn trùng lặp.

Hiểu Xác minh ID kết nối và ID mẫu (Bộ lọc)

Trước khi lưu, Open WebUI gửi yêu cầu mã thông báo Bearer tiêu chuẩn đến điểm cuối /models của nhà cung cấp. Tài liệu của nó lưu ý rằng một số dịch vụ tương thích trả về 400, 401 hoặc 403 cho yêu cầu khám phá này ngay cả khi tính năng hoàn thành trò chuyện vẫn hoạt động. Kiểm tra theo thứ tự này:

  1. Thêm ID mẫu theo cách thủ công trong Model IDs (Filter) và lưu lại.
  2. Bắt đầu cuộc trò chuyện mới và xác nhận rằng mô hình xuất hiện trong bộ chọn.
  3. Chọn nó và gửi tin nhắn để bạn kiểm tra yêu cầu Hoàn thành trò chuyện thực tế.

Chỉ thêm mỗi ID mẫu một lần. Open WebUI cắt khoảng trắng xung quanh. Công tắc bên cạnh kết nối sẽ tạm thời vô hiệu hóa nhà cung cấp mà không xóa cài đặt của nó.

Không thay thế Host.docker.internal bằng API từ xa

Mẹo host.docker.internal chính thức chỉ áp dụng khi vùng chứa Open WebUI phải đến máy chủ mô hình chạy trên máy chủ Docker. TokenHub là dịch vụ HTTPS từ xa, vì vậy hãy giữ https://us-api.tokenhub.com/v1. Nếu chỉ vùng chứa hết thời gian chờ, hãy kiểm tra độ phân giải DNS, quyền truy cập HTTPS gửi đi và cấu hình proxy thay vì thay đổi URL thành localhost.

Xác minh yêu cầu Open WebUI thực sự gửi

  1. Tạo cuộc trò chuyện và chọn mẫu TokenHub mà bạn đã thêm vào danh sách cho phép.
  2. Trước tiên hãy gửi một tin nhắn văn bản ngắn.
  3. Trong nhật ký yêu cầu TokenHub, hãy xác nhận đường dẫn là /v1/chat/completions, ID mẫu máy là chính xác và việc sử dụng đã được ghi lại.
  4. Chỉ sau khi trò chuyện cơ bản hoạt động, các công cụ, hình ảnh và tính năng kiến thức sẽ được kiểm tra riêng. Điều khiển trong Open WebUI không đảm bảo rằng kiểu máy đã chọn hoặc điểm cuối tương thích hỗ trợ khả năng đó.

Đối với 404, trước tiên hãy xác nhận rằng URL kết thúc ở /v1. Nếu thiếu mô hình, hãy quay lại Model IDs (Filter). Nếu lỗi chỉ xảy ra trong Docker, hãy kiểm tra mạng container.

Tài liệu tham khảo chính thức

Chọn mô hình

Khối lượng công việcLựa chọn mô hìnhLý do phù hợp
Tác vụ phức tạpMô hình suy luận hỗ trợ công cụPhù hợp với lập kế hoạch, nhiều bước và ngữ cảnh dài.
Sử dụng hằng ngàyMô hình cân bằngCân bằng chất lượng, tốc độ và chi phí.
Tóm tắt và tác vụ nhẹMô hình nhanh, chi phí thấpGiảm chi phí cho tóm tắt và lặp lại đơn giản.
Xem mô hình TokenHub

Thiết lập Open WebUI API FAQ

Làm cách nào để thêm OpenAI-compatible API vào Open WebUI?

Mở Cài đặt → Quản trị viên → Kết nối và thêm kết nối trong Quản lý kết nối OpenAI API. Nhập khóa TokenHub /v1 URL và API, sau đó lưu lại.

Open WebUI URL có nên bao gồm /chat/completions không?

Không. Sử dụng gốc API kết thúc bằng /v1; Open WebUI xây dựng đường dẫn yêu cầu cho mỗi thao tác.

Tại sao danh sách mẫu Open WebUI lại trống?

Nếu không có tính năng khám phá mô hình, hãy thêm ID mô hình TokenHub chính xác trong Model IDs (Filter), lưu và mở lại bộ chọn mô hình trò chuyện mới.

Tại sao Open WebUI được Dockerized không thể đạt được TokenHub?

Kiểm tra DNS, proxy, chứng chỉ và quyền truy cập ra bên ngoài từ bên trong vùng chứa Open WebUI. Kết nối trình duyệt máy chủ không chứng minh được rằng vùng chứa có quyền truy cập mạng.

Làm cách nào để xác minh Open WebUI đang sử dụng TokenHub?

Chọn mô hình đã định cấu hình trong cuộc trò chuyện mới, gửi tin nhắn ngắn và xác nhận việc sử dụng ID, trạng thái và mã thông báo của mô hình trong nhật ký yêu cầu TokenHub.

Tài liệu tham khảo

Cấu hình này dựa trên TokenHub và tài liệu chính thức; lần xác minh gần nhất: 2026-09-08。