Настройка API в SillyTavern: base URL, API-ключ и список моделей
Updated 2026-07-15
В SillyTavern выберите Chat Completion, установите источник Custom (OpenAI-compatible), вставьте base URL, заканчивающийся на /v1, и добавьте свой API-ключ. Список моделей затем заполнится сам через эндпоинт /v1/models провайдера.
Короткий ответ: пять настроек, которые важны
Откройте панель 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. Один и тот же провайдер, разные правила заполнения полей.
Почему API-адрес SillyTavern заканчивается на /v1
Любой OpenAI-совместимый API — это base URL плюс набор фиксированных маршрутов. GET /v1/models возвращает список ID моделей, доступных вашему ключу. 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 для облачного chat-эндпоинта, вы получите ошибки или испорченное форматирование, а часть сэмплеров, показанных в этом режиме, всё равно не применяется.
Пошаговая настройка
Если после Connect список остаётся пустым, проверьте по порядку три вещи: URL заканчивается на /v1 без лишнего пути и без пробелов в конце, ключ вставлен без кавычек и пробелов, а источник — Custom (OpenAI-compatible), а не обычный OpenAI. Обычный источник 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-массив ID моделей, значит ключ и 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 и просто не отправляются в облачные chat-API, так что искать их здесь не стоит. Пресеты в SillyTavern объединяют две вещи: значения сэмплеров и структуру промпта, которую Prompt Manager собирает из карточки персонажа, персоны и лорбука. Встроенный пресет Default — разумная отправная точка. Меняйте по одному значению за раз и перегенерируйте одну и ту же сцену, чтобы увидеть реальный эффект. Размер контекста заслуживает отдельного внимания: SillyTavern заполняет контекстное окно историей чата, поэтому больший контекст означает больше токенов промпта при каждой реплике — это улучшает память, но одновременно повышает стоимость сообщения.
| Настройка | Стартовое значение | Что делает в ролевой игре |
|---|---|---|
| Temperature | 0.8 | Выше (до 1.1) даёт более разнообразный текст; ниже (0.6), если персонаж отклоняется от карточки |
| Top P | 0.95 | Не трогайте, если только ответы не становятся бессвязными — тогда немного понизьте |
| Frequency penalty | 0.1 | Борется с повторяющимся ритмом фраз в долгих чатах |
| Presence penalty | 0.05 | Небольшие значения не дают теме зацикливаться |
| Max response tokens | 350 | Диапазон 300-500 подходит для ответов-абзацев без излишней болтовни |
| Context size | Лимит модели или 16k | Больше истории на реплику, но и больше входных токенов в стоимости каждого сообщения |
Рекомендуемые модели для SillyTavern
Выбор модели важнее настройки сэмплеров. По приблизительным сообщениям сообщества, семейство DeepSeek V4 лидирует по соотношению цены и качества: deepseek-v4-flash — стандартная рекомендация для долгих чатов, а deepseek-v4-pro лучше удерживает сложные карточки и групповые чаты. GLM-5, Kimi K2.6 и MiMo — крепкие выборы по цене с собственным узнаваемым стилем текста, их стоит подключать по очереди, когда чат начинает казаться однообразным. Grok заметен тем, что опубликованная политика xAI явно разрешает взрослые темы в вымышленных сценариях, что важно для более мрачных сюжетов. Claude пишет лучший текст из всего списка, но политика Anthropic запрещает откровенный контент, поэтому Claude стоит рассматривать как выбор для SFW-творческого письма и сцен в литературном стиле. Два практических замечания. Во-первых, SillyTavern — это ПО, рассчитанное на взрослых, и каждая модель здесь применяет собственную политику контента своего провайдера независимо от вашего фронтенда, поэтому держите карточки и сцены в рамках этих правил. Во-вторых, поскольку список заполняется вживую через /v1/models, можно переключать модель прямо посреди чата и сравнивать ответы на одно и то же сообщение — это самый быстрый способ найти свою любимую.
| ID модели | Сильная сторона в SillyTavern | Заметки о политике контента |
|---|---|---|
| deepseek-v4-flash | Фаворит сообщества для долгих чатов; лучшая цена за сообщение | Гибкая политика для художественного текста; хорошо следует карточкам персонажей |
| deepseek-v4-pro | Точнее следует инструкциям в сложных карточках и групповых чатах | То же семейство, что и Flash, но с лучшей связностью |
| glm-5 | Узнаваемый стиль текста; хороший темп в медленных сценах | Выгодный выбор для чатов с упором на повествование |
| kimi-k2.6 | Хорошая память на длинном контексте для больших лорбуков | Выгодный выбор; справляется с большими карточками, не забывая детали |
| grok-4.5 | Сильная импровизация и живые диалоги | Политика xAI разрешает взрослые темы в вымышленных сценариях |
| claude-sonnet-4-6 | Лучшее качество текста за эти деньги | Только SFW-творческое письмо; Anthropic запрещает откровенный контент |
| claude-opus-4-7 | Лучшее развёрнутое литературное письмо | Та же политика только-SFW, что и у Sonnet |
| gemini-3.5-flash | Быстрые ответы, длинный контекст | Стандартная политика Google; хорошо для приключенческого ролплея |
Сколько на самом деле стоят чаты в SillyTavern
Облачные модели тарифицируются за токен, а ролевые игры сильно нагружают вход: каждая реплика заново отправляет карточку персонажа плюс недавнюю историю. Реплика с 8000 токенов промпта и ответом на 350 токенов стоит около десятой доли цента на deepseek-v4-flash, поэтому нескольких долларов хватает на месяцы неспешного общения. Та же реплика на claude-opus-4-7 стоит примерно в 25 раз больше, поэтому большинство людей используют дешёвую модель как основную и берегут премиальные модели для важных для них сцен. Один ключ шлюза покрывает всю эту таблицу. APIsRouter — это OpenAI-совместимый шлюз с оплатой по факту использования и без подписки: вы платите на /topup без создания аккаунта, ключ приходит на email, первое пополнение добавляет к балансу ещё +100%, глобальные модели стоят на 20% дешевле официальных тарифов, а китайские модели — ниже своих официальных цен.
| Модель | Вход / 1М токенов | Выход / 1М токенов |
|---|---|---|
| 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 |
Частые вопросы
Какой API URL указывать в SillyTavern?
Только base URL, заканчивающийся на /v1. Для APIsRouter это https://api.apisrouter.com/v1. SillyTavern сам добавляет /chat/completions, поэтому ввод полного пути с completions ломает подключение с ошибкой 404.
Есть ли бесплатный API для SillyTavern?
Сам SillyTavern — бесплатное ПО с открытым кодом. Доступ к облачным моделям тарифицируется за токен, хотя некоторые провайдеры предлагают бесплатные тарифы с жёсткими лимитами скорости и очередями. Запуск локальной модели через KoboldCpp бесплатен, если позволяет железо. На практике бюджетные облачные модели вроде deepseek-v4-flash стоят долю цента за сообщение, а это уже достаточно близко к бесплатному для непринуждённого использования без боли от лимитов скорости.
Почему список моделей в SillyTavern пуст?
Вызов Connect к /v1/models не удался. Проверьте, что URL заканчивается на /v1 без лишнего пути и пробелов, ключ вставлен без мусора, а источник — Custom (OpenAI-compatible), а не обычный OpenAI. Протестируйте curl-запрос к /v1/models, чтобы увидеть настоящую ошибку провайдера.
Что использовать в SillyTavern: Chat Completion или Text Completion?
Chat Completion — для любого облачного OpenAI-совместимого API. Text Completion — для локальных бэкендов вроде KoboldCpp и text-generation-webui, принимающих сырую строку промпта. Выбор Text Completion для облачного chat-эндпоинта вызывает ошибки или сломанное форматирование.
Какая модель лучше всего подходит для ролевых игр в SillyTavern?
Начните с deepseek-v4-flash — распространённого выбора сообщества по умолчанию для долгих чатов при низкой стоимости. Переходите на deepseek-v4-pro для сложных карточек, попробуйте GLM-5 или Kimi K2.6 ради другого стиля текста, а Claude используйте для творческого письма самого высокого качества в SFW. Grok подходит для взрослых вымышленных тем в рамках опубликованной политики xAI.
Безопасен ли мой API-ключ в SillyTavern?
Ключи хранятся локально в файле secrets.json SillyTavern на вашем устройстве и отправляются только на настроенный вами хост API. Не публикуйте скриншоты панели подключения и экспортированные файлы настроек, а при подозрении на утечку смените ключ.