SillyTavern

SillyTavern может работать со SpicyAPI двумя способами. Первый — обычное подключение для чата: SillyTavern отправляет ваши сообщения чат-модели SpicyAPI через источник Custom (OpenAI-compatible). Второй — расширение SpicyAPI: оно добавляет команды /spicy-img и /spicy-video и кнопку Animate, так что картинки и короткие видео можно создавать, не выходя из чата.

Можно пользоваться любым из способов отдельно. Оба используют тот же аккаунт, баланс и цены, что и весь SpicyAPI, а платить нужно только за то, что вы запустили. Расширение бесплатное и с открытым исходным кодом (MIT): github.com/spicyapi-ai/sillytavern-spicyapi.

Перед началом

• SillyTavern 1.19.0 или новее. Шаги на этой странице проверены на версии 1.19.0 6 октября 2026 года. В других версиях названия пунктов меню могут отличаться.
• git на машине, где работает SillyTavern — только если нужно расширение. SillyTavern использует его, чтобы скачивать расширения.
• API-ключ. Ключи начинаются с sk-spicy-. Об ограничениях, которые можно задать для ключа, см. Аутентификация, а если аккаунта ещё нет — Подготовка аккаунта.
• Баланс. Каждый запрос оплачивается из предоплаченного баланса в долларах США. См. Оплата.

Подключите чат SillyTavern к SpicyAPI

Запрос чата отправляет сервер SillyTavern, а не ваш браузер, поэтому с вашей стороны больше ничего настраивать не нужно.

Выберите чат-модель

У чат-моделей идентификаторы оканчиваются на /chat. Выпадающий список Available Models заполняется из полного списка моделей SpicyAPI, поэтому в нём есть и модели изображений, видео и звука, которые общаться не могут. Чат-модели идут первыми: выберите одну в начале списка или введите либо вставьте идентификатор с /chat в поле Enter a Model ID.

Чтобы увидеть все чат-модели и то, что принимает каждая из них, откройте чат-модели на сайте или вызовите GET https://api.spicyapi.ai/v1/models со своим ключом (см. Модели). У каждой чат-модели есть поля context_length, max_output_tokens и supported_parameters.

Для ролевых игр рейтинг для ролевых игр ранжирует чат-модели по выдержанности персонажа и по тому, насколько свободно они пишут. Одни чат-модели не имеют цензуры, другие фильтруют содержимое; в каталоге у каждой модели отмечен уровень политики содержимого.

Рекомендуемые настройки

Настройки сэмплирования, которые выбранная модель не поддерживает (например, temperature, top P, frequency penalty и presence penalty), игнорируются, а не отклоняются. SpicyAPI перечисляет пропущенные в заголовке ответа X-Spicy-Ignored-Params. Ползунки в SillyTavern можно не трогать.

Reasoning effort

Выпадающий список Reasoning Effort в SillyTavern моделям SpicyAPI не передаётся. Если вы хотите его задать, добавьте параметр сами и только для модели, у которой в supported_parameters есть reasoning_effort:

1. Нажмите Additional Parameters под кнопкой Connect.
2. В Include Body Parameters добавьте одну строку, например:

reasoning_effort: low

Допустимые значения у разных моделей различаются. Уровень, которого у модели нет, заменяется ближайшим из доступных (он назван в заголовке ответа X-Spicy-Adjusted-Params), а у модели без уровней рассуждения эта строка игнорируется. Сначала посмотрите запись модели в списке моделей. Если ответ пустой или обрывается, увеличьте Response (tokens) или снизьте усилие рассуждения.

Картинки в чате

Когда Send inline media включено, SillyTavern прикладывает картинки из чата к каждому следующему запросу. Модель, не умеющая читать изображения, отклоняет запрос с ошибкой 400, а поскольку картинка остаётся в чате, все следующие сообщения тоже завершаются ошибкой. Для текстовых моделей отключите Send inline media или скройте сообщение с картинкой.

Видео из чата модели не отправляются.

Настройки, которые модель отклоняет

Несколько настроек по-прежнему отклоняются, если модель их не поддерживает, потому что они меняют сам ответ, а не просто подстраивают его: Multiple swipes per generation больше 1 (n), пресеты Logit Bias и Request token probabilities. Если запрос завершается сообщением, где названа одна из этих настроек, выключите её. В тексте ошибки указано имя поля.

Custom Stopping Strings работают на любой модели. Модель без последовательностей stop (например, модели Grok) их игнорирует, а модель, которая принимает меньше, чем вы задали, оставляет первые; какие именно, сообщают заголовки ответа X-Spicy-Ignored-Params и X-Spicy-Adjusted-Params. Значение ползунка за пределами диапазона модели, например temperature 1.5 у модели с максимумом 1, так же снижается до предела.

Расширение SpicyAPI

Расширение создаёт картинки и короткие видео прямо из чата. Установите его один раз, добавьте ключ и выберите модели.

Команды

Именованные аргументы, которые можно добавить к командам:

• model=<id> использует модель только для этого запуска. Нажмите Tab после model=, чтобы увидеть список.
• edit=true открывает редактор промпта, даже если вы ввели промпт.
• quiet=true сохраняет результат и возвращает путь к нему, не публикуя его, — для Quick Replies и STscript.
• avatar=true или avatar=false (только для картинок) переопределяет настройку «использовать аватар персонажа».

/spicy-img a lighthouse on a cliff at dusk, wide shot
/spicy-video waves rolling onto a beach at sunrise
/spicy-video image=last slow push-in, hair moving in the wind

В меню с волшебной палочкой рядом с полем ввода чата есть пункты SpicyAPI picture, SpicyAPI video и SpicyAPI: animate last picture.

Animate

У каждой картинки в чате среди элементов управления есть значок киноплёнки, а у сообщений с картинкой тот же значок есть в меню .... Он превращает картинку в видеоклип с помощью вашей модели «изображение в видео» и добавляет клип в то же сообщение.

Промпты

Если вы не указали промпт, его по текущей сцене пишет чат-модель, к которой вы подключены. При включённой настройке Let me read and edit the prompt before generating (по умолчанию) открывается окно с моделью, точной ценой и промптом в том виде, в каком он написан. Можно подождать, ввести свой промпт или снова нажать Write from the scene. В расширении нет готовых промптов, пресетов и стилей: слова берутся от вас или от вашей чат-модели.

С моделями, принимающими референсную картинку, можно использовать аватар персонажа, чтобы картинка была похожа на него.

Пусть ИИ показывает картинки

По умолчанию выключено. Включите Let the AI show pictures в панели SpicyAPI и выберите, как чат-модель будет просить картинку. Можно использовать любой способ или оба сразу:

У автоматических картинок есть собственные лимиты в дополнение к лимитам на запуск, описанным ниже:

• не чаще одной картинки раз в несколько ответов в каждом чате (по умолчанию 3); отклонённый или неудавшийся запрос тоже запускает ожидание;
• суточный лимит на автоматические картинки в этом браузере (по умолчанию $0.50);
• если сумма выше вашего порога подтверждения, действует либо Ask me first (по умолчанию: показывает описание и цену), либо Skip the picture.

Автоматические запуски создают только картинки, никогда не видео, и, как и любые другие результаты, картинки скрыты от ИИ. Пока инструмент включён, его описание отправляется с каждым запросом чата, а это несколько токенов на вашем API чата. Полное описание работы есть в README расширения.

Цены и лимиты

Перед каждым запуском расширение запрашивает у SpicyAPI расчёт стоимости и показывает его в долларах США. Расчёты бесплатны.

Панель также показывает, сколько потрачено за сессию этого браузера. Для жёсткого лимита, который действует везде, задайте суточный лимит расходов на самом ключе. См. Аутентификация.

Запуск продолжается на стороне SpicyAPI, если вы нажали Stop waiting или закрыли страницу, и оплачивается, если завершился успешно. Заберите результат позже командой /spicy-task <task id>. Неудачные запуски не оплачиваются, кроме немногих моделей, на странице которых сказано, что отклонённые запросы тарифицируются. См. Оплата.

Где хранятся ваш ключ и файлы

• Ваш ключ хранится открытым текстом в файле настроек SillyTavern на машине, где он работает (data/<user>/settings.json, в разделе extension_settings.spicyapi). Другие расширения SillyTavern могут его прочитать. Если вы используете Connect chat, ключ также сохраняется в файле секретов SillyTavern как ключ пользовательского адреса Custom. Поэтому стоит завести отдельный ключ с лимитом расходов.
• Результаты скачиваются и сохраняются в папке изображений SillyTavern (data/<user>/user/images/<character>/spicyapi_<task id>.png или .mp4), после чего прикрепляются к чату. Новые результаты по умолчанию скрыты от ИИ, чтобы следующий запрос чата не отправил картинку модели, которая не умеет её читать. Включите Let the AI see generated pictures and videos, чтобы изменить это.
• Что уходит с вашей машины: промпт, настройки модели и любая референсная картинка отправляются на api.spicyapi.ai. Когда промпт пишет ваша чат-модель, контекст чата уходит в тот чат-API, к которому подключён SillyTavern, как и любое другое сообщение.
• SpicyAPI хранит созданные файлы ограниченное время. См. Хранение и удаление данных.

Если вы переключите чат, пока что-то создаётся, результат будет сохранён, но не добавлен в чат, а расширение сообщит, где он лежит.

Маршрут подключения

По умолчанию расширение обращается к https://api.spicyapi.ai напрямую из вашего браузера. Если сеть или браузер это блокирует, откройте Connection в панели и выберите Auto (сначала напрямую, затем через CORS-прокси SillyTavern) или Through SillyTavern's CORS proxy.

Прокси по умолчанию выключен. Включите его, задав enableCorsProxy: true в config.yaml SillyTavern (или запустив SillyTavern с --corsProxy), и перезапустите. Его нельзя сочетать с базовой аутентификацией SillyTavern (basicAuthMode), которая отклоняет запросы с API-ключом. В этом случае используйте прямой маршрут.

Устранение неполадок

Ошибки SpicyAPI заканчиваются на request_id или идентификатор задачи. Сообщите его в поддержку, и запрос можно будет найти точно. Коды ошибок описаны в разделе Ошибки и повторы.