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

Tổng quan

SillyTavern giao tiếp với UnoRouter qua nguồn Chat Completion. Bạn dán URL gốc, khóa API của mình, rồi chọn một mô hình từ danh sách thả xuống được điền tự động. Không cần máy chủ proxy, không cần reverse tunnel, không cần cấu hình thêm.

Cấu hình nhanh

Sao chép ba giá trị sau vào các trường của nguồn Custom (OpenAI-compatible) trong SillyTavern.

URL gốc: https://api.unorouter.ai/v1
Khóa API:  YOUR_API_KEY
Mô hình:    claude-opus-4-5

Chỉ dán URL gốc. SillyTavern sẽ tự động nối thêm `/chat/completions`. Nếu bạn tự thêm vào, sẽ gặp lỗi 400.

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

1. 1
   Mở AI Response Configuration

   Trong SillyTavern, nhấn biểu tượng phích cắm ở trên cùng để mở bảng API Connections.

2. 2
   Chọn Chat Completion

   Đặt kiểu API thành Chat Completion.

3. 3
   Chọn Custom (OpenAI-compatible)

   Trong danh sách thả xuống Chat Completion Source, chọn Custom (OpenAI-compatible).

4. 4
   Dán URL gốc

   Nhập URL gốc của UnoRouter kết thúc bằng `/v1`. Không thêm `/chat/completions`.

5. 5
   Dán khóa API của bạn

   Dán khóa API UnoRouter vào trường Custom API Key.

6. 6
   Kết nối và chọn mô hình

   Nhấn Connect. Danh sách Model sẽ được điền tự động từ danh sách mô hình của UnoRouter; chọn mô hình bạn muốn dùng.

7. 7
   Tùy chọn: bỏ qua kiểm tra trạng thái

   Nếu SillyTavern vẫn hiển thị thanh cảnh báo dù tin nhắn được gửi đi bình thường, hãy bật Bypass API Status Check.

Cách hoạt động của danh sách mô hình

SillyTavern gọi `GET /v1/models` trên URL gốc của bạn để điền danh sách chọn mô hình. UnoRouter cung cấp endpoint này, vì vậy danh sách sẽ được điền tự động. Nếu danh sách trống, hãy chuyển sang trường Custom Model ID và tự gõ tên mô hình.

Xử lý sự cố

• Lỗi 400 Bad Request ở mọi tin nhắn. Bạn đã nối thêm `/chat/completions` vào URL. Hãy xóa đi; URL gốc phải kết thúc tại `/v1`.
• Danh sách mô hình trống. Kết nối đã thất bại. Kiểm tra lại URL gốc, sau đó bật Bypass API Status Check để SillyTavern không chặn danh sách sớm.
• Lỗi 401 Unauthorized. Khóa API đã hết hạn hoặc bị nhập sai. Tạo khóa mới trong bảng điều khiển UnoRouter rồi dán vào, không để khoảng trắng ở đầu hoặc cuối.
• Lỗi 429 Too Many Requests. Bạn đã chạm giới hạn tốc độ trong gói hiện tại. Hãy chờ một phút hoặc nâng cấp gói trong trang thanh toán của UnoRouter.
• Lỗi SSL hoặc chứng chỉ. Đồng hồ hệ thống của bạn bị sai. Hãy đồng bộ rồi thử lại; SillyTavern dùng kho tin cậy của hệ thống.
• Phản hồi streaming bị ngắt giữa câu. Tắt Streaming trong phần cài đặt tạo sinh để xác nhận vấn đề nằm ở phía luồng, sau đó bật lại. Proxy doanh nghiệp loại bỏ tiền tố `data:` cũng có thể gây ra lỗi này.