Приложения для ролевых игр (RisuAI, Agnai, Chub, KoboldAI Lite, Janitor AI)

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

На этой странице рассмотрены пять веб- и десктопных приложений: RisuAI, Agnai, Chub, KoboldAI Lite и Janitor AI. О SillyTavern см. SillyTavern. Эти приложения делают другие люди, и их экраны меняются; названия полей ниже взяты из опубликованного исходного кода и справочных страниц каждого приложения, а в каждом разделе сказано, что было проверено, а что нет.

Что понадобится

• Аккаунт SpicyAPI с балансом. См. Подготовка аккаунта и Оплата.
• API-ключ, начинающийся с sk-spicy-. См. Аутентификация.
• Идентификатор модели. Текстовые модели называются <maker>/<model>/chat, здесь это записано как MODEL_ID_FROM_CATALOG. MODEL_ID_FROM_CATALOG обозначает идентификатор чат-модели, который нужно скопировать из актуального каталога (GET /api/v1/models); сам плейсхолдер вводить не нужно. Идентификатор нужно ввести точно, включая /chat в конце. Полный список находится на spicyapi.ai/models; с вашим ключом его возвращает и GET https://api.spicyapi.ai/v1/models, а идентификаторы чат-моделей оканчиваются на /chat. См. Модели.

Какое поле заполняется в каком приложении

Разница между коротким и полным адресом существенна. Приложения, которые сами добавляют /chat/completions, ломаются, если вы пишете его в адресе, а Janitor AI требует его указать явно.

Выбор модели

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

На странице каждой модели также есть метка политики содержимого (например, unrestricted, borderline или filtered). Она показывает, насколько свободно модель отвечает; выбирайте модель, метка которой подходит для историй, которые вы хотите писать.

DeepSeek V4.1 Flash — хорошая первая модель: она находится в верхней части рейтинга и входит в число самых дешёвых. Скопируйте её идентификатор (он оканчивается на /chat) из актуального каталога на spicyapi.ai/models, а не вводите по памяти.

Два ограничения, о которых стоит знать:

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

Настройки сэмплирования

Приложения для ролевых игр отправляют с каждым сообщением целый набор настроек сэмплирования: temperature, top-p, top-k, min-p, top-a, frequency, presence и repetition penalty. Модели различаются тем, какие из них принимают.

SpicyAPI игнорирует те, которые модель не использует, вместо того чтобы отклонять сообщение. Он также игнорирует n: 1, пустой список stop и строки stop у модели, которая их не имеет. Когда что-то игнорируется, в ответе есть заголовок X-Spicy-Ignored-Params с названиями отброшенных настроек, так что вы точно видите, что не подействовало.

Если модель принимает настройку, но не присланное вами значение, SpicyAPI берёт ближайшее допустимое: temperature выше максимума модели становится максимумом, а список строк stop длиннее, чем разрешает модель, сохраняет первые. Эти изменения перечисляются в заголовке X-Spicy-Adjusted-Params, например temperature=1, stop=kept 1 of 3. Поэтому привычные пресеты можно оставить как есть.

Поля, не относящиеся к сэмплированию, — другое дело: если приложение отправляет что-то, чего модель вообще не знает, SpicyAPI всё равно отвечает ошибкой 400 с названием этого поля.

Модели с рассуждением и Max tokens

Некоторые модели сначала думают, а потом отвечают. Размышления расходуют токены, и эти токены входят в Max tokens (в разных приложениях он называется также Max output, Response length или max_new_tokens).

• Задавайте Max tokens с запасом. Если значение совсем маленькое, например 20 или 200, модель с рассуждением может потратить весь бюджет на размышления и не вернуть текст. Вы получите ошибку upstream_failed с сообщением, что лимит вывода потрачен на рассуждения. Начните с 1000 и больше и увеличивайте, если ответы обрываются.
• Размышления стоят денег и времени. Токены рассуждения оплачиваются как любой другой вывод, а первое слово приходит позже. Некоторым моделям можно велеть думать меньше с помощью параметра reasoning_effort. Уровни у разных моделей различаются; уровень, которого у модели нет, заменяется ближайшим из доступных, а настройки рассуждения в стиле OpenRouter (их отправляет Agnai) переводятся в reasoning_effort. Приложения с полем Additional Parameters или полем пользовательских параметров могут его передать, например reasoning_effort с меньшим значением; большинство приложений ниже сами его не отправляют.
• Некоторые приложения выводят размышления в чат. Janitor AI оборачивает их в теги <think>. Chub их не показывает вовсе.

Держите расходы под контролем

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

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

Эти приложения хранят ваш ключ на своих серверах или в вашем браузере. Сайт RisuAI, Agnai и Janitor AI пропускают ваш ключ и чат через свои серверы; Chub и KoboldAI Lite отправляют запросы прямо из вашего браузера. Отдельный ключ с лимитом — правильная мера предосторожности в любом случае.

RisuAI

RisuAI работает на risuai.xyz, как десктопное приложение или на вашем собственном сервере. Проверено по исходному коду RisuAI (версия 2026.8.250).

Откуда приходят запросы. На risuai.xyz RisuAI обычно ретранслирует запросы через свой сервер, поэтому ваш ключ и чат проходят через него. Десктопное приложение и собственный сервер отправляют запросы напрямую с вашей машины. Только параметр сайта «Force Plain Fetch», спрятанный среди нерекомендуемых настроек, отправляет запросы из браузера; SpicyAPI принимает и их.

Сэмплирование. Настройки Custom API в RisuAI по умолчанию отправляют frequency, presence и repetition penalty, min-p и top-a. SpicyAPI игнорирует те, которые модель не использует, так что значения по умолчанию работают.

Agnai

Agnai находится на agnai.chat. Проверено по исходному коду Agnai (ветка dev, 6 октября 2026 года). SpicyAPI нет во встроенном списке провайдеров Agnai, поэтому его добавляют как пользовательское OpenAI-совместимое подключение.

Откуда приходят запросы. Если провайдер добавлен таким образом, запрос отправляет сервер Agnai, поэтому ваш ключ хранится у Agnai.

Сэмплирование. Agnai всегда отправляет temperature и top-p, которые некоторые модели не принимают. Для таких моделей SpicyAPI их игнорирует, поэтому модели вроде DeepSeek V4 и Kimi K3 работают.

Не рекомендуется: режимы с прямым обращением из браузера. В Agnai есть также тип подключения Self-Host и переключатель Use Local Requests в старых пресетах, из-за которых ваш браузер обращается к адресу напрямую. Судя по исходному коду, эти режимы добавляют поле think, которое SpicyAPI не принимает, а на неизвестные поля SpicyAPI отвечает 400. С SpicyAPI это не тестировалось. Если вы получили там 400, вернитесь к настройке провайдера, описанной выше.

Chub

Chub (chub.ai) отправляет запросы прямо из вашего браузера на указанный вами адрес. Проверено по опубликованному фронтенд-коду Chub (сборка от 28 июня 2026 года); с тех пор экраны Chub могли измениться. Подключение из браузера работает, потому что SpicyAPI разрешает запросы с веб-страниц.

На собственной странице настроек Chub предупреждает, что при использовании reverse proxy ваш IP-адрес и журнал чата могут записываться. Это замечание Chub, а не SpicyAPI.

Что показывает исходный код и что может удивить:

• Chub перестаёт читать потоковый ответ через 120 секунд. Модель с рассуждением, которая долго думает, может быть оборвана; снизьте её усилие рассуждения или выберите модель, отвечающую быстрее.
• Chub не показывает размышления модели, только её ответ.

KoboldAI Lite

KoboldAI Lite — это одна веб-страница на lite.koboldai.net. Проверено по опубликованному index.html. Она обращается к адресу напрямую из вашего браузера, что работает, потому что SpicyAPI разрешает запросы с веб-страниц.

Оставьте «CORS Proxy» выключенным. В KoboldAI Lite есть параметр, направляющий запросы через прокси, который содержит его автор. Для SpicyAPI он не нужен, а если его включить, ваш ключ пройдёт через чужой сервер.

Сэмплирование. Его настройка повтора отправляется в API как presence penalty. Для моделей, которые её не используют, SpicyAPI её игнорирует.

Janitor AI

Функция «proxy» в Janitor AI отправляет ваш чат на выбранный вами адрес. Согласно справочному центру Janitor, нужные поля находятся под значком шестерёнки на странице чата, в разделе API Settings, затем Add Configuration.

Если Janitor показывает сетевую ошибку или ошибку подключения, например «A network error occurred», скорее всего, страница Janitor блокирует запросы к адресам, отличным от адреса OpenAI. У веб-страницы Janitor есть политика безопасности, разрешающая прямые запросы только к одному стороннему ИИ-адресу — адресу OpenAI. Когда Janitor отправляет запрос из вашего браузера, браузер отказывает ещё до того, как запрос увидит SpicyAPI, и SpicyAPI на это повлиять не может. Если в консоли у вашего ключа нет использования, а эта ошибка появляется, причина именно в этом.

Если вы с этим столкнулись, используйте вместо этого SillyTavern или RisuAI.

Другие факты из справочного центра Janitor и кода страницы:

• У некоторых ботов Janitor авторы отключили прокси, поэтому бот может отказываться общаться через прокси независимо от того, что вы введёте.
• Janitor показывает размышления модели в тегах <think>. Чтобы они были короче, увеличьте Max tokens или снизьте усилие рассуждения.
• Janitor ограничивает длину одного вводимого вами сообщения.

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

Коды ошибок описаны в разделе Ошибки и повторы. Каждая ошибка заканчивается на request_id; сообщите его в поддержку, и запрос можно будет найти точно. Ваши запросы также видны в разделе Logs в консоли — это самый быстрый способ понять, дошёл ли запрос до SpicyAPI вообще.