Налаштування SillyTavern API: base URL, API-ключ і список моделей

Коротка відповідь: п'ять налаштувань, які мають значення

Відкрийте панель API Connections (іконка вилки) і встановіть точно так: API = Chat Completion. Chat Completion Source = Custom (OpenAI-compatible). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = ваш ключ sk-.... Натисніть Connect, дочекайтесь зеленого індикатора і оберіть модель зі списку, наприклад deepseek-v4-flash. Найпоширеніша помилка полягає в тому, щоб вставити повний шлях. SillyTavern сам додає /chat/completions до того, що ви ввели, тому URL має закінчуватись саме на /v1. Якщо вставити https://api.apisrouter.com/v1/chat/completions, SillyTavern запитує /v1/chat/completions/chat/completions і з'єднання падає з помилкою 404. Це протилежно до JanitorAI, якому потрібен повний URL completions у налаштуваннях проксі. Той самий провайдер, різні конвенції полів.

Чому URL SillyTavern API закінчується на /v1

Будь-який OpenAI-сумісний API це base URL плюс набір фіксованих маршрутів. GET /v1/models повертає список ідентифікаторів моделей, доступних вашому ключу. POST /v1/chat/completions виконує сам запит чату. SillyTavern знає ці маршрути і будує їх самостійно, тому просить у вас лише базову адресу. Коли ви натискаєте Connect, він викликає /v1/models з вашим ключем і використовує відповідь, щоб заповнити список моделей. Порожній список майже завжди означає, що цей виклик не вдався. Також потрібно обрати правильний режим API. Chat Completion надсилає структуровані повідомлення з ролями system, user та assistant, і саме це очікує кожен хостинговий OpenAI-сумісний провайдер. Text Completion надсилає один сирий рядок промпту і існує переважно для локальних бекендів на кшталт KoboldCpp та text-generation-webui. Для будь-якого хостингового API-ключа використовуйте Chat Completion. Якщо обрати Text Completion для хостингового чат-ендпоінта, ви отримаєте помилки або зіпсоване форматування, а частина семплерів, показаних у цьому режимі, все одно не застосовується.

Покрокове налаштування

Якщо список залишається порожнім після Connect, перевірте по черзі три речі: URL закінчується на /v1 без зайвого шляху і пробілів у кінці, ключ вставлено без лапок чи пробілів, а джерело це Custom (OpenAI-compatible), а не звичайний OpenAI. Джерело plain OpenAI у деяких версіях ігнорує ваш кастомний URL і звертається до api.openai.com, де ваш ключ недійсний.

• Отримайте ключ. У APIsRouter немає форми реєстрації: оплатіть на /topup, і ключ прийде на email. Будь-який OpenAI-сумісний ключ працює за цими ж кроками.
• У SillyTavern натисніть іконку вилки, щоб відкрити API Connections.
• Встановіть API на Chat Completion.
• Встановіть Chat Completion Source на Custom (OpenAI-compatible).
• У полі Custom Endpoint (Base URL) введіть https://api.apisrouter.com/v1 без нічого після /v1.
• Вставте свій ключ у поле Custom API Key.
• Натисніть Connect. Індикатор статусу стає зеленим, а список Available Models заповнюється з /v1/models.
• Оберіть модель, відкрийте картку персонажа і надішліть коротке тестове повідомлення.

Перевірте з'єднання поза SillyTavern

Коли щось не працює, спершу перевірте ендпоінт напряму, а не звинувачуйте SillyTavern. Цей виклик curl це точно те, що робить кнопка Connect. Якщо він повертає JSON-масив ідентифікаторів моделей, ваш ключ і URL в порядку, а проблема в полях SillyTavern. Якщо список моделей працює, а чати ні, запустіть один справжній запит completion з Python з тим самим base URL. Успішна відповідь тут доводить, що весь ланцюжок працює, а будь-яке повідомлення про помилку це реальна помилка провайдера, а не загальна помилка SillyTavern.

curl https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

Основи семплерів і пресетів

Джерела Chat Completion надають невеликий набір семплерів: temperature, top P, frequency penalty та presence penalty, а також довжину відповіді і розмір контексту. Складніші семплери, про які ви могли читати (min P, mirostat, dynamic temperature), належать бекендам Text Completion і просто не надсилаються до хостингових чат-API, тож не шукайте їх тут. Пресети в SillyTavern об'єднують дві речі: значення семплерів і структуру промпту, яку Prompt Manager збирає з картки персонажа, персони та lorebook. Вбудований пресет Default є розумною відправною точкою. Змінюйте по одному значенню за раз і перегенеровуйте ту саму сцену, щоб побачити, що воно насправді робить. Розмір контексту заслуговує на увагу: SillyTavern заповнює контекстне вікно історією чату, тож більший контекст означає більше токенів промпту на кожен хід, що покращує пам'ять і водночас підвищує вартість повідомлення.

Рекомендовані моделі для SillyTavern

Вибір моделі важливіший за налаштування семплерів. Консенсус спільноти, наскільки дозволяють судити приблизні звіти, ставить родину DeepSeek V4 на перше місце за співвідношенням ціни: deepseek-v4-flash є типовою рекомендацією для довгих чатів, а deepseek-v4-pro краще тримає складні картки і групові чати. GLM-5, Kimi K2.6 та MiMo є надійними вигідними варіантами з відмінними голосами прози, варті ротації, коли чат починає здаватись одноманітним. Grok вирізняється тим, що опублікована політика xAI прямо дозволяє дорослі теми у вигаданих сеттингах, що важливо для темніших сюжетів. Claude пише найкращу прозу з усього цього списку, але політика Anthropic забороняє відверто сексуальний контент, тож розглядайте Claude як вибір для SFW творчого письма і сцен у літературному стилі. Дві практичні примітки. По-перше, SillyTavern це софт для дорослих, і кожна модель тут застосовує власну політику контенту провайдера незалежно від вашого фронтенду, тож тримайте картки і сцени в межах цих правил. По-друге, оскільки список заповнюється наживо з /v1/models, ви можете перемикати моделі посеред чату і порівнювати відповіді на те саме повідомлення, що є найшвидшим способом знайти власного фаворита.

Скільки насправді коштують чати в SillyTavern

Хостингові моделі рахують за токен, а рольова гра важка на вхідні дані: кожен хід повторно надсилає картку персонажа плюс недавню історію. Хід, що надсилає 8000 токенів промпту і отримує відповідь на 350 токенів, коштує близько десятої частки центу на deepseek-v4-flash, тож кілька доларів покривають місяці неквапливого спілкування. Той самий хід на claude-opus-4-7 коштує приблизно у 25 разів більше, тому більшість людей використовують дешеву модель для щоденного використання, а преміальні моделі бережуть для сцен, які їм справді важливі. Один ключ шлюзу покриває всю цю таблицю. APIsRouter це OpenAI-сумісний шлюз з оплатою за фактичне використання і без підписки: ви оплачуєте на /topup без створення акаунту, ключ приходить на email, перше поповнення додає відповідні +100% до балансу, глобальні моделі коштують на 20% нижче офіційних тарифів, а китайські моделі дешевші за свої офіційні ціни.

Поширені запитання