APIMaster.ai

Open WebUI + APIMaster.ai

Cài đặt Open WebUI với Docker và kết nối APIMaster.ai như một nhà cung cấp tương thích OpenAI.

Open WebUI là một giao diện chat tự lưu trữ cho các LLM. APIMaster.ai cung cấp một API tương thích OpenAI tại https://apimaster.ai/v1 — cấu hình nó dưới mục Kết nối để sử dụng các mô hình marketplace.

Lấy Khóa API trước. Mã mô hình bạn chọn trong chat phải khớp chính xác với marketplace (ví dụ: gpt-5.4, claude-sonnet-4-6).


Điều kiện tiên quyết

  1. Docker đã được cài đặt (macOS, Linux hoặc Windows).
  2. Kết nối WebSocket được cho phép (cần thiết bởi Open WebUI — xem Hướng dẫn Bắt đầu Nhanh chính thức).
  3. Một Khóa API APIMaster từ bảng điều khiển.

Bước 1 — Cài đặt Open WebUI với Docker

Ba bước này tuân theo Hướng dẫn Bắt đầu Nhanh Open WebUI với Docker.

1.1 Kéo image

docker pull ghcr.io/open-webui/open-webui:main

Tương đương Docker Hub: openwebui/open-webui:main.

1.2 Chạy container

docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main
Cờ Mục đích
-p 3000:8080 Giao diện tại http://localhost:3000
-v open-webui:/app/backend/data Lưu trữ liên tục

Đối với môi trường sản xuất, gắn thẻ phát hành (ví dụ: :v0.9.6) — xem các biến thể image.

1.3 Mở giao diện

http://localhost:3000

Tài khoản đầu tiên được tạo sẽ trở thành Quản trị viên; các đăng ký sau cần phê duyệt (sau khi cài đặt).


Bước 2 — Mở cài đặt Kết nối

  1. Đăng nhập với tư cách quản trị viên.
  2. Mở Cài đặtKết nối.
  3. Dưới OpenAI API, bật công tắc chính lên.
  4. Đặt URL thành:
https://apimaster.ai/v1

Cài đặt → Kết nối

Sử dụng bánh răng hoặc + bên cạnh URL để mở trình chỉnh sửa kết nối (bước tiếp theo).


Bước 3 — Chỉnh sửa kết nối APIMaster

Trong Chỉnh sửa Kết nối:

Trường Giá trị
URL https://apimaster.ai/v1
Xác thực Bearer
Khóa API Khóa APIMaster của bạn
Nhà cung cấp Mặc định
Loại API Chat Completions
ID Mô hình Để trống — tải các mô hình từ https://apimaster.ai/v1/models

Chỉnh sửa Kết nối

Để trống HeadersPrefix ID. Bật công tắc kết nối, sau đó Lưu.


Bước 4 — Chọn mô hình và chat

  1. Đi tới Chat Mới.
  2. Mở Chọn mô hình và chọn một mô hình APIMaster (ví dụ: gpt-5.4).
  3. Tùy chọn Đặt làm mặc định.
  4. Gửi một tin nhắn thử nghiệm.

Bộ chọn mô hình

Phiên chat

Nếu thiếu mô hình, hãy kiểm tra khóa của bạn, quyền truy cập nhóm và mã mô hình marketplace; bạn cũng có thể thêm một id cụ thể dưới ID Mô hình.


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

Danh sách mô hình trống hoặc lỗi kết nối

  • URL phải là https://apimaster.ai/v1.
  • Xác thực khóa bằng yêu cầu đầu tiên.
  • Đảm bảo https://apimaster.ai/v1/models có thể truy cập từ máy của bạn.

WebSocket / cập nhật trực tiếp

Open WebUI cần hỗ trợ WebSocket; cấu hình proxy ngược của bạn nếu không sử dụng localhost.

Cập nhật

Xem cập nhật Open WebUI: xóa container → kéo image → chạy lại với cùng volume.


Xem thêm