Hướng dẫn tích hợp RisuAI

Tổng quan

Ô Custom Models của RisuAI cho phép bạn dán Request URL, khóa API và ID mô hình. Cạm bẫy là một công tắc tên Autofill Request URL: khi bật, RisuAI sẽ viết lại URL bạn dán, làm đứt kết nối một cách âm thầm.

Cấu hình nhanh

Sao chép ba giá trị sau vào các trường Custom Models trong Advanced Settings của RisuAI.

Request URL: https://api.unorouter.ai/v1/chat/completions
Khóa API:    YOUR_API_KEY
ID mô hình:   claude-opus-4-5

Dán URL đầy đủ kết thúc bằng `/v1/chat/completions`. RisuAI không có danh sách mô hình ở chế độ Custom Models; Model ID là trường văn bản thủ công.

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

1. 1
   Mở Advanced Settings

   Trong RisuAI, mở Settings, sau đó mở Advanced Settings.

2. 2
   Chọn một ô mô hình

   Nhấn bộ chọn mô hình Chat Bot, cuộn xuống cuối danh sách và chọn Custom Models.

3. 3
   Bỏ tick Autofill Request URL

   Công tắc này phải TẮT trước khi bạn dán bất cứ thứ gì. Xem cảnh báo quan trọng ở trên.

4. 4
   Dán Request URL

   Dán URL đầy đủ kết thúc bằng `/v1/chat/completions`.

5. 5
   Dán khóa API

   Dán khóa API UnoRouter vào trường API Key. Một số bản RisuAI gọi trường này là Authorization; hãy dùng trường đó nếu trường API Key không xuất hiện.

6. 6
   Dán Model ID

   Gõ hoặc dán chính xác tên mô hình từ trang models của UnoRouter.

7. 7
   Lưu

   Đóng bảng cài đặt; RisuAI ghi cấu hình vào local storage.

8. 8
   Gửi tin nhắn thử

   Mở một đoạn chat bất kỳ và gửi tin nhắn thử để kiểm tra phản hồi.

Vì sao công tắc autofill quan trọng

Autofill Request URL được thêm vào để ngăn lỗi gõ nhầm với các nhà cung cấp preset có tên. Với Custom Models, nó lại thành điểm chí mạng: RisuAI viết lại URL tùy chỉnh của bạn sang mặc định không trỏ tới chúng tôi. Nếu một bản cập nhật RisuAI bật lại công tắc này, hãy làm lại bước 3 trước khi gỡ lỗi bất cứ thứ gì khác.

Cấu hình Auxiliary Model

RisuAI dùng một ô mô hình thứ hai cho các tác vụ dịch, tóm tắt và đoán tên. Lặp lại bước 2 đến 7 cho bộ chọn Auxiliary Model, dùng cùng URL và khóa UnoRouter.

Xử lý sự cố

• Lỗi 404 hoặc 'Invalid URL'. Autofill Request URL đang bật khi bạn dán; RisuAI đã viết lại URL. Bỏ tick công tắc và dán lại Request URL.
• Trước đây hoạt động, giờ không phản hồi. Bản cập nhật RisuAI có thể âm thầm bật lại Autofill Request URL. Mở Custom Models và xác nhận công tắc vẫn tắt.
• Lỗi 401 Unauthorized. Một số bản RisuAI đồng thời cung cấp cả trường API Key và Authorization; chỉ một trong hai được đọc tùy theo phiên bản. Hãy chuyển khóa sang trường còn lại rồi thử lại.
• Không tìm thấy mô hình. Model ID phải khớp chính xác với tên một mô hình. Sao chép từ trang models của UnoRouter; đừng gõ lại.
• Chức năng dịch hoặc tóm tắt bị hỏng. Auxiliary Model chưa được cấu hình. Lặp lại thiết lập cho ô Auxiliary Model.
• Đầu ra streaming bị chia khúc hoặc thiếu mảnh. Bộ phân tích SSE của RisuAI yêu cầu sự kiện `data:` thuần túy. Proxy doanh nghiệp loại bỏ tiền tố này sẽ gây streaming lỗi. Hãy thử trên mạng không phải doanh nghiệp nếu có thể.
• Cài đặt bị reset sau khi khởi động lại trình duyệt. RisuAI lưu cấu hình trong local storage của trình duyệt, mà một số chế độ riêng tư sẽ xóa. Hãy xuất cấu hình ra file từ Settings để sao lưu.