Cài đặt API SillyTavern: base URL, API key và danh sách model
Updated 2026-07-15
Trong SillyTavern, chọn Chat Completion, đặt nguồn thành Custom (OpenAI-compatible), dán base URL kết thúc ở /v1, và thêm API key. Danh sách model sẽ tự động điền từ endpoint /v1/models của provider.
Câu trả lời nhanh: năm cài đặt quan trọng
Mở panel API Connections (biểu tượng phích cắm) và đặt chính xác như sau: API = Chat Completion. Chat Completion Source = Custom (OpenAI-compatible). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = key sk-... của bạn. Nhấn Connect, đợi đèn xanh, và chọn một model từ danh sách, ví dụ deepseek-v4-flash. Lỗi phổ biến nhất là dán cả đường dẫn đầy đủ. SillyTavern tự thêm /chat/completions vào bất cứ gì bạn nhập, nên URL phải dừng lại ở /v1. Nếu bạn dán https://api.apisrouter.com/v1/chat/completions, SillyTavern sẽ gọi /v1/chat/completions/chat/completions và kết nối thất bại với lỗi 404. Điều này ngược lại với JanitorAI, nơi cần URL completions đầy đủ trong cấu hình proxy. Cùng một provider, nhưng quy ước field khác nhau.
Vì sao API URL của SillyTavern kết thúc ở /v1
Mọi API tương thích OpenAI đều là một base URL cộng với một tập route cố định. GET /v1/models trả về danh sách model ID mà key của bạn có thể dùng. POST /v1/chat/completions chạy request chat thực tế. SillyTavern biết các route này và tự xây dựng chúng, nên chỉ hỏi bạn base URL. Khi bạn nhấn Connect, nó gọi /v1/models với key của bạn và dùng response để điền danh sách model. Danh sách trống gần như luôn có nghĩa là lệnh gọi đó thất bại. Bạn cũng cần chọn đúng API mode. Chat Completion gửi tin nhắn có cấu trúc với vai trò system, user và assistant, đây là điều mọi provider tương thích OpenAI hosted đều mong đợi. Text Completion gửi một chuỗi prompt thô duy nhất và tồn tại chủ yếu cho backend local như KoboldCpp và text-generation-webui. Với bất kỳ key API hosted nào, hãy dùng Chat Completion. Nếu bạn chọn Text Completion với một endpoint chat hosted, bạn sẽ gặp lỗi hoặc định dạng lộn xộn, và nhiều sampler hiển thị ở mode đó cũng không áp dụng được.
Cài đặt từng bước
Nếu danh sách vẫn trống sau khi Connect, kiểm tra lại theo thứ tự ba điều: URL kết thúc ở /v1 không có đường dẫn thừa hay khoảng trắng thừa, key được dán không có dấu ngoặc kép hay khoảng trắng, và nguồn là Custom (OpenAI-compatible) chứ không phải OpenAI thường. Nguồn OpenAI thường bỏ qua URL tùy chỉnh của bạn ở một số phiên bản và giao tiếp với api.openai.com, nơi key của bạn không hợp lệ.
- Lấy một key. Trên APIsRouter không có form đăng ký: trả tiền tại /topup và key sẽ được gửi qua email. Bất kỳ key tương thích OpenAI nào cũng hoạt động tương tự trong các bước này.
- Trong SillyTavern, nhấn biểu tượng phích cắm để mở API Connections.
- Đặt API thành Chat Completion.
- Đặt Chat Completion Source thành Custom (OpenAI-compatible).
- Trong Custom Endpoint (Base URL), nhập https://api.apisrouter.com/v1 không thêm gì sau /v1.
- Dán key của bạn vào field Custom API Key.
- Nhấn Connect. Chấm trạng thái chuyển xanh và danh sách Available Models được điền từ /v1/models.
- Chọn một model, mở một character card, và gửi một tin nhắn test ngắn.
Xác minh kết nối bên ngoài SillyTavern
Khi có gì đó thất bại, hãy test endpoint trực tiếp trước khi đổ lỗi cho SillyTavern. Lệnh curl này chính xác là những gì nút Connect thực hiện. Nếu nó trả về một mảng JSON các model ID, key và URL của bạn ổn và vấn đề nằm ở các field trong SillyTavern. Nếu danh sách model hoạt động nhưng chat thất bại, hãy chạy một completion thực từ Python với cùng base URL. Một phản hồi thành công ở đây chứng minh toàn bộ chuỗi, và bất kỳ thông báo lỗi nào bạn nhận được là lỗi thực của provider chứ không phải lỗi chung chung của SillyTavern.
curl https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer sk-your-key"Cơ bản về sampler và preset
Các nguồn Chat Completion cung cấp một tập sampler nhỏ: temperature, top P, frequency penalty, và presence penalty, cùng độ dài phản hồi và kích thước context. Các sampler cầu kỳ hơn mà bạn có thể đã đọc qua (min P, mirostat, dynamic temperature) thuộc về backend Text Completion và đơn giản là không được gửi tới API chat hosted, nên đừng tìm chúng ở đây. Preset trong SillyTavern gộp hai thứ: giá trị sampler và cấu trúc prompt mà Prompt Manager lắp ráp từ character card, persona và lorebook của bạn. Preset Default có sẵn là điểm khởi đầu hợp lý. Thay đổi từng giá trị một và tạo lại cùng một cảnh để xem nó thực sự làm gì. Kích thước context đáng được chú ý: SillyTavern lấp đầy context window bằng lịch sử chat, nên context lớn hơn nghĩa là gửi nhiều token prompt hơn ở mỗi lượt, điều này cải thiện trí nhớ và đồng thời tăng chi phí mỗi tin nhắn.
| Cài đặt | Điểm khởi đầu | Tác dụng trong roleplay |
|---|---|---|
| Temperature | 0.8 | Cao hơn (tới 1.1) cho văn phong đa dạng; thấp hơn (0.6) nếu nhân vật lệch khỏi tính cách đã định |
| Top P | 0.95 | Giữ nguyên trừ khi phản hồi trở nên khó hiểu, khi đó hạ nhẹ xuống |
| Frequency penalty | 0.1 | Chống lại nhịp câu lặp lại trong các chat dài |
| Presence penalty | 0.05 | Giá trị nhỏ hạn chế việc quẩn quanh một chủ đề |
| Max response tokens | 350 | 300 đến 500 phù hợp với phản hồi dạng đoạn văn mà không lan man |
| Context size | Giới hạn của model hoặc 16k | Nhiều lịch sử hơn mỗi lượt; cũng nhiều input token hơn bị tính phí mỗi tin nhắn |
Model khuyên dùng cho SillyTavern
Việc chọn model quan trọng hơn việc tinh chỉnh sampler. Theo đồng thuận cộng đồng, ở mức độ các báo cáo tương đối, dòng DeepSeek V4 đứng đầu về giá: deepseek-v4-flash là lựa chọn mặc định cho chat dài và deepseek-v4-pro giữ các card phức tạp và group chat chặt chẽ hơn. GLM-5, Kimi K2.6, và MiMo là lựa chọn giá trị vững chắc với chất giọng văn riêng, đáng để xoay vòng khi một chat bắt đầu cảm thấy nhàm. Grok đáng chú ý vì chính sách công khai của xAI cho phép rõ ràng các chủ đề trưởng thành trong bối cảnh hư cấu, điều quan trọng cho các cốt truyện tối hơn. Claude viết văn hay nhất trong danh sách này nhưng chính sách của Anthropic cấm nội dung explicit, nên hãy coi Claude là lựa chọn cho viết sáng tạo SFW và các cảnh phong cách văn học. Hai lưu ý thực tế. Thứ nhất, SillyTavern là phần mềm hướng đến người trưởng thành, và mọi model ở đây đều thực thi chính sách nội dung riêng của provider bất kể frontend bạn dùng, nên hãy giữ card và cảnh trong khuôn khổ các quy tắc đó. Thứ hai, vì danh sách được điền trực tiếp từ /v1/models, bạn có thể đổi model giữa chat và so sánh phản hồi cho cùng một tin nhắn, đây là cách nhanh nhất để tìm ra model yêu thích của riêng bạn.
| Model ID | Điểm mạnh trong SillyTavern | Ghi chú chính sách nội dung |
|---|---|---|
| deepseek-v4-flash | Được cộng đồng ưa chuộng cho chat dài; giá trị tốt nhất mỗi tin nhắn | Chính sách linh hoạt cho hư cấu; theo character card tốt |
| deepseek-v4-pro | Theo chỉ dẫn tốt hơn cho card phức tạp và group chat | Cùng dòng với Flash nhưng mạch lạc hơn |
| glm-5 | Chất giọng văn riêng; nhịp độ tốt trong các cảnh chậm | Lựa chọn giá trị cho chat nặng về tường thuật |
| kimi-k2.6 | Nhớ context dài cho lorebook lớn | Lựa chọn giá trị; xử lý card lớn mà không quên |
| grok-4.5 | Ứng biến và đối đáp mạnh | Chính sách xAI cho phép chủ đề trưởng thành trong bối cảnh hư cấu |
| claude-sonnet-4-6 | Chất lượng văn xuôi cao nhất so với giá tiền | Chỉ viết sáng tạo SFW; Anthropic cấm nội dung explicit |
| claude-opus-4-7 | Viết văn học dài tốt nhất | Cùng chính sách chỉ SFW như Sonnet |
| gemini-3.5-flash | Phản hồi nhanh, context dài | Chính sách chuẩn của Google; tốt cho RP phong cách phiêu lưu |
Chat SillyTavern thực sự tốn bao nhiêu
Model hosted tính phí theo token, và roleplay nặng về input: mỗi lượt gửi lại character card cộng lịch sử gần đây. Một lượt gửi 8.000 token prompt và nhận phản hồi 350 token tốn khoảng một phần mười cent trên deepseek-v4-flash, nên vài đô la đủ dùng cho nhiều tháng chat thông thường. Cùng lượt đó trên claude-opus-4-7 tốn gấp khoảng 25 lần, đó là lý do hầu hết mọi người dùng một model rẻ hàng ngày và dành model cao cấp cho các cảnh họ thực sự quan tâm. Một key gateway bao phủ toàn bộ bảng này. APIsRouter là gateway tương thích OpenAI với thanh toán theo lượng dùng và không subscription: bạn trả tiền tại /topup mà không cần tạo tài khoản, key được gửi qua email, lần nạp đầu tiên của bạn cộng thêm +100% vào số dư, model toàn cầu có giá thấp hơn 20% so với giá chính thức, và model Trung Quốc nằm dưới giá chính thức của chúng.
| Model | Input / 1M token | Output / 1M token |
|---|---|---|
| deepseek-v4-flash | $0.126 | $0.252 |
| deepseek-v4-pro | $0.3915 | $0.783 |
| glm-5 | $0.514 | $2.314 |
| gemini-3.5-flash | $1.20 | $7.20 |
| claude-sonnet-4-6 | $2.40 | $12.00 |
| claude-opus-4-7 | $4.00 | $20.00 |
| gpt-5.5 | $4.00 | $24.00 |
| grok-4.5 | $1.60 | $4.80 |
Câu hỏi thường gặp
Tôi nên nhập URL API nào vào SillyTavern?
Chỉ base URL, kết thúc ở /v1. Với APIsRouter đó là https://api.apisrouter.com/v1. SillyTavern tự thêm /chat/completions, nên nhập cả đường dẫn completions đầy đủ sẽ làm hỏng kết nối với lỗi 404.
Có API miễn phí cho SillyTavern không?
Bản thân SillyTavern là phần mềm mã nguồn mở miễn phí. Truy cập model hosted tính phí theo token, dù một số provider cung cấp tier miễn phí với rate limit và hàng đợi chặt. Chạy model local qua KoboldCpp là miễn phí nếu phần cứng của bạn đủ mạnh. Trong thực tế, model hosted giá rẻ như deepseek-v4-flash tốn một phần nhỏ của cent mỗi tin nhắn, đủ gần với miễn phí cho việc dùng thông thường mà không gặp rắc rối rate limit.
Vì sao danh sách model SillyTavern của tôi trống?
Lệnh gọi Connect tới /v1/models đã thất bại. Kiểm tra URL kết thúc ở /v1 không có đường dẫn hay khoảng trắng thừa, key được dán sạch, và nguồn là Custom (OpenAI-compatible) chứ không phải OpenAI thường. Test bằng curl với /v1/models để xem lỗi thực của provider.
Tôi nên dùng Chat Completion hay Text Completion trong SillyTavern?
Chat Completion cho bất kỳ API hosted tương thích OpenAI nào. Text Completion dành cho backend local như KoboldCpp và text-generation-webui nhận một chuỗi prompt thô. Chọn Text Completion với một endpoint chat hosted sẽ gây lỗi hoặc định dạng hỏng.
Model nào tốt nhất cho roleplay trong SillyTavern?
Bắt đầu với deepseek-v4-flash, lựa chọn mặc định phổ biến của cộng đồng cho chat dài với chi phí thấp. Chuyển sang deepseek-v4-pro cho card phức tạp, thử GLM-5 hoặc Kimi K2.6 để có chất giọng văn khác, và dùng Claude cho viết sáng tạo SFW chất lượng cao nhất. Grok phù hợp với chủ đề hư cấu trưởng thành theo chính sách công khai của xAI.
API key của tôi có an toàn trong SillyTavern không?
Key được lưu cục bộ trong file secrets.json của SillyTavern trên máy bạn và chỉ được gửi tới API host bạn đã cấu hình. Đừng chia sẻ screenshot của panel kết nối hay file cài đặt đã export, và đổi key nếu bạn nghi ngờ nó bị lộ.