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

Tổng quan

SillyTavern kết nối tới Routerah qua nguồn Chat Completion. Dán URL cơ sở và khóa API của bạn, rồi chọn một mô hình từ danh sách thả xuống. Không cần proxy hay đường hầm.

Cấu hình nhanh

Dán những giá trị này vào ứng dụng khách. Khóa của bạn tự điền khi đã đăng nhập.

URL cơ sở: https://api.routerah.app/v1
Khoá API: YOUR_API_KEY

Tương thích

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

1. 1
   Mở API Connections

   Nhấp 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 Routerah kết thúc bằng `/v1`. Không thêm `/chat/completions`.

   text

   Custom Endpoint (Base URL): https://api.routerah.app/v1

   Đăng nhập để tự động điền API key

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

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

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

   Nhấp Connect. Danh sách Model sẽ được lấp đầy từ danh sách mô hình của Routerah.

Chạy trên Android (Termux)

SillyTavern không có ứng dụng Android, nhưng chạy được trên điện thoại trong Termux. Cài một lần theo các bước này, mở trong trình duyệt điện thoại, rồi kết nối Routerah theo các bước ở trên.

1. 1
   Cài Termux

   Tải Termux từ F-Droid hoặc trang phát hành trên GitHub. Bản trên Play Store không còn được duy trì và không hoạt động.

2. 2
   Chọn mirror và cập nhật

   Mở Termux và chạy lệnh đầu tiên. Chọn Mirror group và một khu vực gần bạn, rồi cập nhật các gói.

   bash

   termux-change-repo
   pkg update && pkg upgrade

   Đăng nhập để tự động điền API key

3. 3
   Cài các thành phần cần thiết

   Lệnh này cài Git và Node.js. Trên điện thoại 32-bit đời cũ, hãy chạy thêm `pkg install esbuild` nếu khởi động báo lỗi Unsupported platform.

   bash

   pkg install git nodejs-lts nano

   Đăng nhập để tự động điền API key

4. 4
   Tải SillyTavern

   Lệnh này tải bản ổn định vào thư mục home của Termux.

   bash

   git clone https://github.com/SillyTavern/SillyTavern -b release

   Đăng nhập để tự động điền API key

5. 5
   Khởi động SillyTavern

   Mở http://127.0.0.1:8000 trong trình duyệt điện thoại và làm theo các bước thiết lập ở trên. Để Termux chạy nền trong lúc trò chuyện. Để khởi động lại sau này, hãy chạy hai lệnh này.

   bash

   cd ~/SillyTavern
   bash start.sh

   Đăng nhập để tự động điền API key

6. 6
   Cập nhật SillyTavern

   Chạy lệnh này mỗi khi bạn muốn bản mới nhất. Nhân vật và cuộc trò chuyện của bạn vẫn được giữ.

   bash

   cd ~/SillyTavern
   git pull --rebase --autostash

   Đăng nhập để tự động điền API key

Mô hình đề xuất

Các mô hình miễn phí hoạt động ở đây. Dán bất kỳ model id nào vào ứng dụng khách.

Lưu ý

• !Chỉ dán URL cơ sở kết thúc bằng `/v1`. SillyTavern tự thêm `/chat/completions`; nếu bạn tự thêm sẽ nhận lỗi 400.
• !Danh sách model trống nghĩa là kết nối đã thất bại. Hãy kiểm tra lại URL gốc, rồi bật Bypass API status check.
• !Lỗi 401 nghĩa là khoá đã hết hạn hoặc gõ sai. Hãy tạo một khoá mới trong bảng điều khiển Routerah và dán nó mà không có khoảng trắng ở đầu hoặc cuối.
• !Nếu luồng bị cắt giữa câu, hãy tắt Streaming để xác nhận nguyên nhân, rồi bật lại. Các proxy doanh nghiệp cắt bỏ tiền tố `data:` cũng làm hỏng nó.