Cấu hình API tương thích OpenAI cho Open WebUI trong 5 phút
Để sử dụng cài đặt API tương thích OpenAI cho open webui, bạn thêm một kết nối với URL cơ sở và khóa, và mô hình sẽ xuất hiện trong trình chọn. Dưới đây là hướng dẫn chính xác cho Abliterated API, từ Docker đến cuộc trò chuyện đầu tiên.
Cập nhật

Điểm chính
- URL cơ sở là https://api.abliteratedapi.com/v1 và ID mô hình là
uncensored. - Bạn thêm nó trong cài đặt kết nối quản trị, hoặc truyền OPENAI_API_BASE_URL và OPENAI_API_KEY cho Docker.
- Bạn kiểm tra khóa bằng curl trước, để bạn có thể phân biệt lỗi khóa với lỗi giao diện.
- Open WebUI chỉ là giao diện phía trước: bạn trả tiền theo token cho những gì mô hình đọc và viết, và không cần thẻ để bắt đầu.
Tóm tắt nhanh
Nếu bạn muốn thiết lập API tương thích OpenAI cho open webui trong một đoạn văn: mở cài đặt quản trị, thêm kết nối API OpenAI, đặt URL thành https://api.abliteratedapi.com/v1, dán khóa của bạn, lưu và chọn mô hình tên là uncensored. Đó là tất cả. Open WebUI giao tiếp với bất kỳ thứ gì triển khai định dạng hoàn thành trò chuyện OpenAI, và API này làm được điều đó.
Dịch vụ là một API văn bản tương thích OpenAI được lưu trữ, chạy một mô hình trọng số mở, được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp. Nó được vận hành bởi một nhà cung cấp độc lập và không phải là API chính thức của bất kỳ phòng thí nghiệm mô hình nào. Open WebUI chỉ là giao diện trò chuyện phía trước mà bạn trỏ vào nó.
Trước khi bắt đầu
- Một khóa API. Tạo một cái trên trang khóa API. Đăng ký bằng Google hoặc bằng email và mật khẩu. Người dùng mới có thể nhận $0,50 tín dụng dùng thử chỉ với một cú nhấp chuột trên trang đó, có giá trị trong 7 ngày và không cần thẻ.
- Open WebUI đang chạy. Cài đặt qua Docker hoặc pip đều hoạt động. Các bước dưới đây bao gồm Docker và màn hình cài đặt.
- Truy cập mạng từ máy chạy Open WebUI đến
api.abliteratedapi.comqua HTTPS.
Kiểm tra khóa trước khi chạm vào giao diện. Nếu lệnh gọi này trả về danh sách chứa uncensored, thì khóa và URL đều chính xác:
curl https://api.abliteratedapi.com/v1/models -H "Authorization: Bearer $ABLITERATED_API_KEY"
Sau đó, bạn xác nhận một yêu cầu chat completion thực tế hoạt động:
curl https://api.abliteratedapi.com/v1/chat/completions -H "Authorization: Bearer $ABLITERATED_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'Phương pháp 1: thêm kết nối trong cài đặt
Đây là cách dễ nhất và hoạt động trên một cài đặt hiện có. Nhãn menu thay đổi giữa các phiên bản Open WebUI, vì vậy các tên dưới đây có thể khác một chút.
- Đăng nhập vào Open WebUI với tư cách quản trị viên và mở Bảng điều khiển quản trị, sau đó Cài đặt, rồi Kết nối.
- Tìm phần API OpenAI và thêm kết nối mới bằng nút dấu cộng.
- Trong trường URL, nhập
https://api.abliteratedapi.com/v1. Dừng lại ở/v1. Không thêm/chat/completions; ứng dụng Open WebUI tự thêm đường dẫn này. - Dán khóa của bạn vào trường khóa. Khóa được gửi dưới dạng
Authorization: Bearer <key>. - Bạn sử dụng nút xác minh bên cạnh các trường nếu phiên bản của bạn có, sau đó lưu.
Mở một cuộc trò chuyện mới và mở trình chọn mô hình. Mô hình uncensored phải có trong danh sách, vì Open WebUI đọc nó từ GET /v1/models. Nếu danh sách vẫn trống, hãy chuyển đến phần khắc phục sự cố bên dưới.
Phương pháp 2: thiết lập khi khởi động bằng Docker
Đối với cài đặt mới, hãy truyền endpoint dưới dạng biến môi trường. Open WebUI đọc OPENAI_API_BASE_URL và OPENAI_API_KEY khi nó khởi động.
# base URL: https://api.abliteratedapi.com/v1 model to pick in the UI: uncensored
docker run -d -p 3000:8080 -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1" -e OPENAI_API_KEY="$ABLITERATED_API_KEY" -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
Sau đó, truy cập http://localhost:3000, tạo tài khoản đầu tiên (tài khoản này sẽ trở thành quản trị viên) và bắt đầu một cuộc trò chuyện. Volume đặt tên sẽ giữ lại các cuộc trò chuyện và cài đặt của bạn khi bạn cập nhật container.
Một điều khiến mọi người bất ngờ: nhiều cài đặt Open WebUI được lưu vào cơ sở dữ liệu của nó sau lần khởi chạy đầu tiên, và giá trị đã lưu có thể ghi đè biến môi trường sau đó. Nếu bạn thay đổi khóa hoặc URL trong Docker và không có gì xảy ra, hãy thay đổi nó trong màn hình Kết nối, hoặc đặt lại cài đặt đã lưu.
Các cài đặt nên điều chỉnh
Khi trò chuyện hoạt động, một vài tùy chọn giúp trải nghiệm tốt hơn và giữ hóa đơn có thể dự đoán được.
Sử dụng cửa sổ ngữ cảnh một cách hợp lý
Cửa sổ ngữ cảnh là 100.000 token, dùng chung cho prompt và câu trả lời. Open WebUI gửi lại lịch sử trò chuyện trong mỗi tin nhắn, nên một cuộc hội thoại dài sẽ tốn kém hơn sau mỗi lượt. Ở mức $0,15 cho mỗi 1M token đầu vào, lịch sử 20.000 token tốn $0,003 để gửi, điều này rẻ nhưng sẽ tích lũy qua hàng nghìn tin nhắn. Hãy bắt đầu một cuộc trò chuyện mới cho một chủ đề mới.
Truyền phát và lấy mẫu
Open WebUI truyền phát phản hồi theo mặc định và API hỗ trợ truyền phát qua SSE. Trong các tham số nâng cao, bạn có thể đặt nhiệt độ, top_p, các chuỗi dừng, hạt giống để tạo đầu ra có thể lặp lại và các hình phạt. Những tham số này được chuyển tiếp đến mô hình. Để max_tokens trống trừ khi bạn muốn giới hạn cứng, vì đây là tham số tùy chọn.
Nhiệm vụ nền
Open WebUI có thể thực hiện các lệnh gọi mô hình bổ sung trong nền cho các việc như đặt tên cho cuộc trò chuyện. Mỗi lệnh gọi là một yêu cầu thực sự trên số dư của bạn và tính vào giới hạn. Nếu bạn nhận thấy các lệnh gọi mà bạn không nhập, hãy xem cài đặt mô hình nhiệm vụ và trỏ chúng vào một mô hình bạn sẵn sàng trả tiền, hoặc tắt các tính năng trợ giúp.
Preset và prompt hệ thống
Open WebUI cho phép bạn lưu một bộ cài đặt mô hình trong phần không gian làm việc của nó: tên, mô hình cơ sở, prompt hệ thống và các tham số mặc định. Tạo một bộ cài đặt trên nền uncensored cho mỗi công việc bạn thường làm, chẳng hạn như trợ lý chỉnh sửa, người xem xét mã hoặc nhân vật cho phiên truyện tương tác. Một prompt hệ thống ngắn nêu rõ vai trò, giọng điệu và định dạng phản hồi sẽ hiệu quả hơn nhiều so với việc dán các hướng dẫn dài vào mọi cuộc trò chuyện.
Đây là nơi hồ sơ mô hình phát huy tác dụng. Đây là mô hình trọng số mở được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp, phù hợp với truyện hư cấu, nhập vai và bạn đồng hành cho người lớn, nơi việc từ chối giữa cảnh sẽ làm gián đoạn luồng. Nó không thay đổi giới hạn cứng: không có nội dung tình dục liên quan đến người chưa thành niên, không bao giờ. Hãy giữ các cài đặt mặc định và các instance dùng chung trong quy tắc đó và trong luật pháp nơi bạn sinh sống.
Nếu những người khác sử dụng phiên bản Open WebUI của bạn, hãy nhớ rằng họ đều dùng chung khóa của bạn và các giới hạn của nó. Một khóa đầy đủ cho phép 8 yêu cầu đồng thời, nên một nhóm nhỏ người dùng hoạt động là ổn, trong khi một nhóm lớn trò chuyện cùng lúc có thể chạm ngưỡng giới hạn. Việc cấp cho mỗi người hoặc nhóm một khóa riêng sẽ phân tán tải và giúp theo dõi số dư dễ dàng hơn.
Chi phí vận hành
Bạn trả tiền cho token, từ tín dụng trả trước: $0,15 cho mỗi 1M token đầu vào và $0,50 cho mỗi 1M token đầu ra. Các yêu cầu bị lỗi hoặc bị từ chối không bị tính phí và tín dụng không bao giờ hết hạn. Một tin nhắn trò chuyện điển hình với 3.000 token lịch sử và phản hồi 400 token tốn $0,00045 + $0,0002 = $0,00065, vì vậy $10 cho mức sử dụng là khoảng 15.000 tin nhắn.
Các khoản nạp tiền có giá trị từ $20 đến $500 với bất kỳ số nguyên nào, với +5% từ $50, +10% từ $100 và +15% từ $200. Bạn có thể thanh toán bằng tiền mã hóa (USDT trên TRC20, USDC trên Base). Xem trang giá cả để biết chi tiết. Số dư còn lại được trả trong tiêu đề X-Balance-USD của mỗi phản hồi API, nếu bạn muốn theo dõi nó từ một script.
Khắc phục sự cố
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| Danh sách mô hình trống | URL hoặc khóa sai | Chạy lệnh kiểm tra curl cho /v1/models. URL phải kết thúc bằng /v1. |
| Kết nối bị từ chối hoặc hết thời gian chờ từ Docker | Không có HTTPS hướng ra khỏi container | Kiểm tra cài đặt DNS, proxy và tường lửa trên máy chủ. |
| Lỗi xác thực trên mọi tin nhắn | Khóa được dán có chứa khoảng trắng, hoặc khóa cũ | Sao chép lại khóa từ trang khóa và lưu lại. |
| Lỗi khi nhiều người trò chuyện cùng lúc | Giới hạn tốc độ | Khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 mỗi phút; khóa dùng thử cho phép 2 và 60. |
| Cuộc trò chuyện dài ngừng hoạt động | Cửa sổ ngữ cảnh đã đầy | Cửa sổ chứa 100.000 token. Hãy bắt đầu một cuộc trò chuyện mới hoặc tóm tắt. |
Nếu lệnh curl kiểm tra thành công nhưng Open WebUI thất bại, vấn đề nằm ở cài đặt giao diện người dùng. Nếu lệnh curl thất bại, hãy kiểm tra khóa và số dư của bạn trước. Tài liệu khởi động nhanh liệt kê mọi tham số yêu cầu, và bài viết về API trò chuyện không kiểm duyệt là gì và không phải là gì giải thích phạm vi của mô hình, bao gồm giới hạn cứng: không có nội dung tình dục liên quan đến người chưa thành niên.
Hướng dẫn khác
Hỏi đáp
Tôi nhập URL nào vào Open WebUI?
Sử dụng https://api.abliteratedapi.com/v1 và không thêm gì sau đó. Open WebUI tự động thêm /chat/completions và /models.
Tôi chọn tên mô hình nào?
ID mô hình là uncensored. Nó sẽ xuất hiện trong trình chọn mô hình sau khi kết nối được lưu và danh sách mô hình tải xong.
Tôi có cần thẻ để dùng thử không?
Không. Người dùng mới có thể nhận $0,50 tín dụng dùng thử chỉ với một cú nhấp chuột trên trang khóa API sau khi đăng ký. Tín dụng này có giá trị trong 7 ngày và không cần thẻ.
Tôi có thể chạy nó cùng với các mô hình cục bộ không?
Có. Open WebUI hỗ trợ nhiều kết nối cùng lúc, nên endpoint này có thể nằm cạnh các mô hình cục bộ và mỗi endpoint đều hiển thị trong cùng một trình chọn mô hình.
Cuộc trò chuyện của tôi có được dùng để huấn luyện không?
Không. Các prompt gửi đến API không được dùng để huấn luyện. Lịch sử trò chuyện được lưu trữ bởi Open WebUI vẫn nằm trong cài đặt của riêng bạn.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.
Lấy khóa API