Руководство по интеграции API SillyTavern: подключите GPTProto и начните ролевую игру

Шаг 1: Установка и запуск SillyTavern

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

Подготовьте Node.js LTS, Git, аккаунт GPT Proto с доступным балансом API и ID модели. Облачный инференс через GPT Proto не требует загрузки весов модели или запуска нейросети на вашем GPU.

Установка на macOS

Загрузите LTS-версию со страницы загрузки Node.js, выберите macOS и используйте установщик, если предпочитаете графическую установку.

Выберите текущий LTS-релиз для вашей операционной системы.

Откройте терминал и проверьте Git:

git --version

Установите Git, если необходимо, затем выполните:

cd ~
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
bash start.sh

Первый запуск устанавливает зависимости. Не закрывайте терминал во время использования SillyTavern и откройте локальный адрес, отображенный в нем, если браузер не запустился автоматически. Эти команды соответствуют официальной инструкции по установке на macOS.

Первый запуск загружает необходимые зависимости.

Для повторного запуска в будущем:

cd ~/SillyTavern
bash start.sh

Установка на Windows

Установите Node.js LTS и Git for Windows. Создайте папку, например C:\AI, откройте её в проводнике, введите cmd в адресной строке и нажмите Enter. Выполните:

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

Откройте загруженную папку SillyTavern и дважды кликните по Start.bat. Оставьте консоль открытой во время общения. В официальном руководстве для Windows рекомендуется избегать системных папок Windows, таких как Program Files, и запускать файл без прав администратора.

Шаг 2: Подключение SillyTavern к GPT Proto

Войдите в GPT Proto и откройте страницу модели GLM-5.3. В разделе «API Usage» указан идентификатор модели и поле для создания API-ключа. Создайте или выберите свой ключ, проверьте текущий тариф и убедитесь, что на балансе достаточно средств для небольшого теста.

В SillyTavern откройте API Connections, используя иконку штекера на верхней панели. Введите:

Вставьте сам ключ в поле для ключа. Не добавляйте туда Bearer, кавычки или полный HTTP-заголовок.

В официальной инструкции для Custom endpoint указан базовый URL без /chat/completions; SillyTavern добавляет этот суффикс автоматически. Для данного подключения поле endpoint должно заканчиваться на /v1.

Если вы ранее следовали нашему руководству по настройке API Janitor AI, обратите внимание на разницу: Proxy URL в Janitor использует полный адрес https://gptproto.com/v1/chat/completions. Копирование этого полного адреса в поле Base URL в SillyTavern приведет к ошибке.

Сопоставьте источник, базовый URL, ключ и ID модели с полями выше.

Нажмите Connect, а затем Test Message. Вы также можете отправить Hello с экрана приветствия. В ходе прохождения руководства был получен ответ, показанный ниже.

Базовое сообщение подтверждает, что соединение работает и может генерировать ответы.

Пустой список доступных моделей (Available Models) не обязательно означает, что генерация недоступна. Введите точный ID вручную, если автоматическое обнаружение моделей не работает. Чтобы переключиться на другие модели позже, используйте другой поддерживаемый ID текстовой модели GPT Proto и протестируйте снова; возможности моделей и принимаемые параметры могут различаться.

Шаг 3: Импорт карточки персонажа или создание своей

Рабочее API-подключение предоставляет модель. Карточка персонажа задает личность, голос и начальную ситуацию.

Импорт существующей карточки персонажа

Откройте Characters → Import Character, выберите скачанный файл карточки и выберите импортированного персонажа, чтобы начать чат. Вы также можете просматривать персонажей через Extensions → Download Extensions & Assets.

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

Создание Ноа Беннетта из текста

Выберите Создать нового персонажа. Начните с имени, описания и первого сообщения; позже вы сможете добавить расширенные поля. Описание рассказывает нейросети о персонаже. Первое сообщение задает начальную сцену и демонстрирует желаемый стиль общения. В руководстве по созданию персонажей объясняются оба этих поля.

Используйте редактор персонажей для настройки личности и начальной сцены ИИ.

Установите Имя как Ноа Беннетт. Вставьте этот оригинальный пример в поле Описание. {{char}} относится к персонажу, а {{user}} — к выбранному вами профилю пользователя.

Вы играете роль {{char}}, Ноа Беннетта, 25-летнего парня с мускулистым телосложением, легкой улыбкой и теплым, ласковым характером.

ВНЕШНОСТЬ
Рост Ноа 188 см, у него широкие плечи, сильные руки, рельефная грудь и крепкие ноги, натренированные годами силовых тренировок. У него слегка взъерошенные темно-каштановые волосы, теплые карие глаза, легкая щетина и ямочка на щеке, которая появляется, когда он ухмыляется. Обычно он носит облегающие футболки, удобные джоггеры и кроссовки. Его голос низкий и теплый, он легко смеется.

ЛИЧНОСТЬ
Ноа — милый парень с игривой уверенностью в себе. Он внимателен, тактилен и не стесняется проявлять привязанность. Ему нравится заставлять {{user}} улыбаться с помощью мягких подколов, заботливых жестов и искренних комплиментов. Его привлекательность заключается в сочетании внушительного телосложения и удивительно доброго сердца.

У него есть свое мнение, друзья, амбиции и иногда бывают плохие дни. Иногда он скрывает волнение за шуткой и становится очаровательно смущенным, когда {{user}} ловит его на сентиментальности. Он умеет признавать ошибки и смеяться над собой.

ПРЕДЫСТОРИЯ
Ноа работает тренером по силовой подготовке и мечтает открыть небольшой районный спортзал. В свободное время он любит готовить, ходить в походы, смотреть ужасные романтические комедии и экспериментировать с рецептами блинов. Он серьезно относится к тренировкам, но никогда не осуждает людей за их тело или уровень физической подготовки.

ОТНОШЕНИЯ С {{user}}
Ноа и {{user}} — дружелюбные соседи, которые в последнее время стали проводить больше времени вместе. Он испытывает симпатию к {{user}} и проявляет интерес через внимание, игривый флирт и приглашения заняться обычными делами вместе. Пусть их близость развивается через реальное взаимодействие.

СТИЛЬ ФЛИРТА
Его флирт теплый, конкретный и слегка дерзкий. Он может чуть дольше удерживать зрительный контакт, запомнить любимый напиток или признаться, что нашел повод зайти. Он замечает реакцию {{user}} и естественно подстраивается. Привязанность должна ощущаться как желанная и взаимная.

СТИЛЬ РОЛЕВОЙ ИГРЫ
Придерживайтесь характера Ноа на протяжении всей истории. Используйте естественные диалоги, небольшие физические жесты и конкретные детали вместо длинных объяснений личности.
Пишите действия в *звездочках*, а диалоги — в кавычках.
Обычно отвечайте одним-тремя короткими абзацами, оставляя место для участия {{user}}.
Управляйте только речью, действиями и мыслями Ноа. Оставьте диалоги, решения и чувства {{user}} пользователю.
Сохраняйте установленные детали и реагируйте непосредственно на то, что только что произошло.
Используйте естественный английский язык, если {{user}} не попросит использовать другой язык.

Вставьте это в поле Первое сообщение:

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

«Прежде чем ты что-то скажешь — да, я умею готовить не только курицу с рисом».

*Он приподнимает бумажный пакет, и на его щеке появляется ямочка, когда он улыбается.*

«Булочки с корицей. Я приготовил слишком много». *Короткая пауза.* «Ладно, я сделал больше, потому что надеялся увидеть тебя».

«Так… ты свободна выпить кофе?»

Завершите создание персонажа, затем выберите Ноа. Основные инструкции сохраните в поле «Описание», а вступительную реплику — в «Первом сообщении». «Заметки создателя» содержат метаданные для тех, кто читает карточку, и не используются для формирования промпта модели.

В готовой карточке Ноа его постоянная личность отделена от приветственного сообщения.

Установите свою персону

Персонажи определяют личность ИИ. Персоны определяют вашу. Откройте Управление персонами, создайте и выберите персону, при желании добавьте имя, аватар и описание, следуя официальным инструкциям по настройке персоны.

Для этой вымышленной сцены достаточно краткого описания:

{{user}} — взрослый человек, который недавно переехал в этот район. Ноа и {{user}} — дружелюбные соседи, которые знакомятся друг с другом. {{user}} самостоятельно решает, что говорить, как действовать, какие делать выборы и что чувствовать.

Используйте вымышленные детали, которые, по вашему мнению, должен знать персонаж; вам не нужно вводить свою реальную биографию. Больше идей по созданию персонажей можно найти в руководстве как создать своего ИИ-персонажа через API.

Шаг 4: Начните свой первый ролевой чат

Откройте чат с Ноа и прочитайте приветствие. На скриншоте пользователь отвечает да, и Ноа отвечает: «Да? Окей. Отлично». Затем он продолжает приглашение на кофе с помощью действий и диалога. Это сгенерированное продолжение — полезная проверка соединения.

Чтобы попробовать более конкретный промпт, отправьте:

«Значит, булочки с корицей были просто предлогом, чтобы увидеться со мной?»
*Я бросаю взгляд на бумажный пакет, а затем снова на него.*

Проверьте, соответствует ли ответ личности Ноа, реагирует ли он на ваш последний ввод и оставляет ли он решения за вами. Если стиль требует доработки, отредактируйте одну часть карточки и начните новый чат. Избегайте одновременного изменения модели, промпта персонажа и нескольких настроек сразу; так будет сложнее понять, что именно помогло.

Опционально: Добавьте информацию о мире (World Info) своему персонажу

World Info, также называемая лорбуком, добавляет информацию о сеттинге в промпт при заданных условиях. Для первого эксперимента добавьте одну локацию из сцены с Ноа.

Откройте World Info, создайте лорбук и добавьте активную запись, используя стратегию активации по ключевым словам. Используйте следующие примерные значения:

В панели персонажа Ноа используйте Еще… → Привязать World Info или кнопку с глобусом, чтобы связать лорбук с ним. Затем спросите: Что такое Corner Cafe?

В документации по World Info объясняется, что содержимое записи — это то, что попадает в промпт; одно лишь название не дает фактов. Активация также зависит от настроек и доступного бюджета, и модель может использовать не все предоставленные детали. Начните с одной краткой записи и проверьте её работу, прежде чем добавлять большой мир.

Сколько стоит SillyTavern с GPT Proto?

GLM-5.3 — это модель, используемая в данном руководстве. Выбирайте модель в зависимости от бюджета, естественности диалога, эмоциональной выразительности, последовательности персонажа и скорости ответа. Сравнивайте кандидатов с одной и той же карточкой и начальной сценой. Для ежедневных чатов учитывайте в бюджете расходы на сохраняемый контекст; для сюжетных сцен проверяйте, насколько убедительно звучит голос и оставляет ли модель выбор за вами.

Сам SillyTavern бесплатен. Генерация моделей GPT Proto использует ваш баланс API. На момент написания этого руководства стоимость GLM-5.3 на 15% ниже официальных тарифов на ввод и вывод в GPT Proto:

Тарифы проверены 3 ноября 2026 года. Актуальные цены и информацию о кэшировании смотрите на панели цен GLM-5.3.

Пример запроса с 8 000 входящих токенов без кэша и 500 оплачиваемыми исходящими токенами стоит:

(8 000 ÷ 1 000 000 × $1.19) + (500 ÷ 1 000 000 × $3.74)
= $0.01139

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

Входящие данные могут включать инструкции персонажа, личность (Persona), выбранный лор и сохраненную историю разговора. Как объясняется в обзоре подключения API, SillyTavern собирает их в промпт. Более длинный сохраненный контекст может увеличить стоимость ответа, даже если ваше последнее сообщение состоит только из слова да.

Почему стоит выбрать GPT Proto для вашего API в SillyTavern?

GPT Proto предлагает модели от официальных провайдеров со скидками на избранные модели, включая GLM-5.3. Один ключ и общий баланс покрывают доступ к нескольким провайдерам. В SillyTavern сохраняйте свои карточки персонажей и настройки Custom-подключения, переключайтесь на другой поддерживаемый ID чат-модели и сравнивайте ответы.

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

Перед началом долгой сессии проверьте доступность модели, стоимость ввода/вывода, скорость ответа и правила обработки данных. Начните с небольшого теста и оцените использование. Страница моделей SillyTavern позволяет изучить варианты и сравнить расходы.

Распространенные проблемы API в SillyTavern и их решение

Начните с нового чата и короткого сообщения. Затем найдите симптом в списке ниже:

Модели с функцией рассуждения требуют особого внимания. В официальном руководстве по рассуждению объясняется, что процесс «мышления» может потреблять токены ответа, даже если он скрыт. Слишком маленький лимит для такой модели может привести к пустому или незавершенному видимому ответу. Проверяйте параметр «Максимальная длина ответа» (Max Response Length) в соответствии с требованиями модели, а не применяйте один и тот же низкий лимит ко всем моделям.

В одном обсуждении сообщества о лорбуках и пустых ответах пользователь решил проблему, удалив пресет и увеличив лимит ответа. Поскольку оба действия были выполнены одновременно, нельзя однозначно выделить одну причину. Это подтверждает практический порядок устранения неполадок: добейтесь работы простого чата, а затем добавляйте пресеты и лор по одному изменению за раз.

Опционально: тестирование API вне SillyTavern

Если ваш ключ сохранен в переменной окружения GPTPROTO_API_KEY, эта команда для macOS/Linux отправит прямой запрос, используя формат Chat Completions со страницы модели:

curl --request POST "https://gptproto.com/v1/chat/completions" \
  --header "Authorization: Bearer $GPTPROTO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "glm-5.3",
    "messages": [
      {"role": "user", "content": "Reply with: API connection works."}
    ]
  }'

Проверьте, получен ли успешный ответ с сгенерированным текстом, а не просто индикатор соединения. Если это работает, а SillyTavern — нет, сравните поля клиента и добавленные параметры. Если оба варианта не работают, изучите возвращенную ошибку аутентификации, баланса, модели или сервиса. Не публикуйте реальные ключи в публичных постах с вопросами по устранению неполадок.