Hướng dẫn Baiyun API: Hướng dẫn Truy cập WebUI Mở
Các bước cấu hình, các điều kiện tiên quyết áp dụng và các vấn đề tương thích phổ biến. Bao gồm các bước kiểm tra đầy đủ, xác minh thực tế và xử lý lỗi.
Hướng dẫn truy cập WebUI mở
Chuẩn bị trước khi sử dụng
Tồn tạiQuản lý khóaTạo một khóa gọi riêng cho công cụ này để xác nhận tài khoản đã hoàn thành và số dư DK là đủ. Phiên bản khách hàng ảnh hưởng đến tên mục; trang này giải thích các mục cấu hình; Vui lòng tham khảo phiên bản hiện tại của giao diện thực tế.
Các bước cấu hình
Vào trang kết nối backend với tư cách quản trị viên, thêm kết nối API OpenAI và điền URL cơ sở cùng khóa. Làm mới danh sách mô hình sau khi lưu; Quyền kết nối và các mẫu có sẵn của người dùng được thiết lập bởi quản trị viên Open WebUI của bạn.
| Các mục cấu hình | Điền nội dung |
|---|---|
| Base URL | https://api.baiyun.si/v1 |
| API Key | Khóa gọi đặc thù cho khách hàng này |
| Ví dụ mô hình | gpt-6-luna |
| Giao thức trò chuyện thông thường | OpenAI Compatible Chat Completions |
| Thỏa thuận Nhà cung cấp Codex | Responses |
Xác thực tối thiểu
Đầu tiên, tắt tìm kiếm trực tuyến, hình ảnh, tệp đính kèm, cơ sở kiến thức và các công cụ tự động thực thi, sau đó gửi một câu đơn giản. Xác minh rằng khách hàng thực sự đã chọn nhà cung cấp của chúng tôi, sau đóNhật ký sử dụngXem mô hình này và mức tiêu thụ. Nút kết nối khách hàng chỉ có thể kiểm tra danh sách mẫu và không thể thay thế một cuộc trò chuyện thật.
Câu hỏi thường gặp
Khi một địa chỉ yêu cầu một điểm cuối đầy đủ, địa chỉ Chat nên là https://api.baiyun.si/v1/chat/completions； Khi yêu cầu URL cơ sở, hãy sử dụng địa chỉ trong bảng. Xuất hiện /v1/v1 Hoặc lặp lại /chat/completions Vào thời điểm đó, địa chỉ được thay đổi trước. 401 Xác minh chìa khóa và nhà cung cấp hiệu quả; 429 Dừng kiểm tra song song và chờ; 404 Kiểm tra các giao thức và mô hình; không ngụy trang các giao thức không được hỗ trợ thành một mô hình khác.
Khả năng và dữ liệu
Trang này cung cấp hướng dẫn cấu hình và không hoàn thành kiểm thử thực tế đầy đủ tính năng cho từng phiên bản khách. Mô hình tùy chỉnh không đảm bảo quyền truy cập vào các tính năng hoàn thiện mô hình chính thức, công cụ hoặc đăng ký của khách hàng. Khách hàng bên thứ ba có thể tải lên phiên hoặc cấu hình dữ liệu đồng bộ; xem xét cài đặt quyền riêng tư trước khi sử dụng; Không xuất công khai các cấu hình chứa khóa.
Hồ sơ khách hàng chính thức · Mô tả Thỏa thuận Trang web · Khắc phục sự cố
Danh sách kiểm tra trước khi sử dụng thực tế
- Hãy chuẩn bị tài khoản và khóa truy cập của riêng bạn, và không sử dụng thông tin đăng nhập chung của người khác.
- Ghi lại các phiên bản máy khách, hệ thống và mô hình cần sử dụng để dễ dàng tái tạo trong quá trình khắc phục sự cố.
- Lưu cấu hình gốc hoặc ảnh chụp màn hình, ẩn khóa, mã xác minh và nội dung riêng tư.
- Xác nhận rằng kiểm tra có thể tiêu tốn một lượng nhỏ DK, bắt đầu với một câu duy nhất và một yêu cầu duy nhất.
- Xem lại trang plaza và trạng thái mô hình hiện tại trước khi quyết định có bật thêm tính năng hay không.
Điều tra chi tiết: thu hẹp phạm vi vấn đề để
Đầu tiên, xác nhận tài khoản đã đầy đủ, khóa hợp lệ và số dư DK đủ, sau đó xác minh giao thức, địa chỉ và mẫu mã sản phẩm. Thực hiện yêu cầu văn bản tối thiểu bằng cùng khóa; Chỉ sau khi thành công thì nó mới khôi phục tệp đính kèm, công cụ hoặc tự động thử lại từng mục. Sau khi lưu cấu hình máy khách, mở lại phiên làm việc để tránh sử dụng nhà cung cấp trước đó trong phiên cũ.
Cách xác nhận rằng phần này đã được học
Đừng chỉ kiểm tra vào thông báo "Cấu hình đã lưu thành công". Bạn nên có thể trình bày rõ ràng URL cơ sở hiện tại, cách sử dụng khóa, mô hình đã chọn và giao thức yêu cầu, đồng thời xác minh kết quả thao tác trên bảng điều khiển tương ứng. Hướng dẫn phía máy khách sử dụng một phản hồi văn bản thuần duy nhất và nhật ký tương ứng làm tiêu chuẩn hoàn thành ban đầu; Hướng dẫn tài khoản dựa trên thông tin bảo mật toàn diện; Hướng dẫn thanh toán sử dụng sự tương ứng giữa phí chính, phí kênh và DK làm tiêu chuẩn.
Nếu xảy ra lỗi, hãy ghi lại thời gian xảy ra, trạng thái HTTP, nội dung lỗi ẩn danh và kết quả thực tế dự kiến. Không chụp màn hình toàn bộ khóa trang, và không cung cấp mật khẩu hoặc mã xác minh cho người khác. Đối với 401, xác thực nên được giải quyết trước; đối với 400, các tham số nên được giải quyết trước; đối với 429, các lần thử lại quy mô lớn nên được dừng lại; đối với 404, cần xác minh các đường dẫn yêu cầu và xác minh trước; việc nạp lại không thể khắc phục tất cả các lỗi.
Một nhiệm vụ nhỏ phù hợp để luyện tập
Hoàn thành các bước tối thiểu trong phần này trong môi trường thử nghiệm của bạn, ghi lại bằng văn bản "cách bạn thiết lập ban đầu, mục bạn đã chỉnh sửa và kết quả bạn thấy." Đừng xem dữ liệu sản xuất, thanh toán thực tế hoặc các lệnh không thể phục hồi là những bài tập. Nếu bạn gặp các tính năng vượt quá những gì phần này cung cấp, trước tiên hãy xem hướng dẫn giao thức tương ứng trước khi cân nhắc thêm tính năng; Chỉ thay đổi một cấu hình tại một thời điểm giúp dễ dàng đánh giá bước nào dẫn đến lỗi.
Bước tiếp theo là ranh giới của phiên bản
Quay lại bản đồ học tập đầy đủ · Cấu hình trang API được đơn giản hóa · Tình trạng thời gian thực của trang web này。
Hướng dẫn được biên soạn vào ngày 9 tháng 10 năm 2026. Giao diện và khả năng cụ thể có thể khác nhau tùy theo phiên bản khách hàng và upstream; Hướng dẫn cấu hình không có nghĩa là tất cả các phiên bản client đều đã vượt qua bài kiểm tra. Đối với thanh toán số dư, đăng nhập QQ / Alipay và các kênh mở, vui lòng tham khảo trang thực tế; Giao diện nén: Trước đây, các kênh hình ảnh upstream 404 và raw không khả dụng, nên đừng nghĩ rằng các tệp cấu hình có thể tự động bị xóa.