Hướng dẫn tích hợp Chub / Venus

Tổng quan

Bảng Secrets của Chub chấp nhận URL `/v1/chat/completions` đầy đủ cùng với khóa API của bạn. Nút Check your proxy xác minh kết nối trước khi bạn chọn mô hình trong Prompt Structure.

Cấu hình nhanh

Sao chép hai giá trị sau vào các trường Reverse proxy trong bảng Secrets của Chub.

URL: https://api.unorouter.ai/v1/chat/completions
Khóa: YOUR_API_KEY

Dán URL đầy đủ kết thúc bằng `/v1/chat/completions`. Chub yêu cầu đường dẫn đầy đủ; đừng chỉ dán URL gốc.

Thiết lập từng bước

1. 1
   Mở bảng Secrets

   Nhấn biểu tượng hamburger ở góc trên bên phải của Chub, sau đó chọn Secrets.

2. 2
   Mở rộng OpenAI

   Nhấn vào phần OpenAI để mở rộng.

3. 3
   Cuộn đến Reverse proxy

   Mục con Reverse proxy chứa các trường URL và Key cùng nút Check your proxy.

4. 4
   Dán URL và khóa

   URL kết thúc bằng `/v1/chat/completions`. Key là khóa API UnoRouter của bạn.

5. 5
   Nhấn Check your proxy

   Chờ xác nhận màu xanh. Nếu thất bại, kiểm tra lại URL và dán lại khóa.

6. 6
   Mở Configuration

   Quay lại menu hamburger, chọn Configuration, sau đó Prompt Structure.

7. 7
   Chọn OpenAI và một mô hình

   Đặt danh sách API thành OpenAI, sau đó chọn mô hình mục tiêu từ danh sách mô hình.

Danh sách mô hình cần proxy vượt qua kiểm tra

Chub chỉ điền danh sách mô hình trong Prompt Structure sau khi kiểm tra proxy thành công. Nếu danh sách trống, hãy quay lại và chạy lại Check your proxy trong Secrets → OpenAI → Reverse proxy.

Xử lý sự cố

• Nút Check your proxy thất bại. URL sai. Nó phải kết thúc bằng `/v1/chat/completions`; chỉ dùng URL gốc sẽ không vượt qua.
• Danh sách mô hình trống. Kiểm tra proxy chưa vượt qua. Chạy lại bước 5 và chờ trạng thái màu xanh.
• Phản hồi trả về rỗng. Prompt Structure đang chọn sai API. Mở Configuration → Prompt Structure và chuyển danh sách API sang OpenAI.
• Lỗi 401 Unauthorized. Khóa API của bạn đã bị xoay hoặc gõ nhầm. Tạo khóa mới trong bảng điều khiển UnoRouter, sau đó dán lại vào Reverse proxy.
• Cảnh báo độ dài ngữ cảnh. Giảm max context trong Prompt Structure, hoặc chọn một mô hình có ngữ cảnh lớn hơn trên trang models của UnoRouter.
• Sau khi tải lại, kiểm tra proxy báo thành công nhưng tin nhắn vẫn lỗi. Chub cache trạng thái kiểm tra proxy qua các phiên. Hãy nhấn Check your proxy một lần trong phiên mới để buộc kiểm tra lại.