Решение проблем: как исправить ошибки TavernAPI в SillyTavern

Проверьте в первую очередь

Прежде чем искать отдельные коды ошибок, пробегитесь по этому 60-секундному чек-листу на вкладке API Connections в SillyTavern (значок вилки на верхней панели). Исправление мелкой неточности здесь сразу решает большинство проблем с подключением:

1. Источник Chat Completion: В поле API выберите Chat Completion, а в списке Chat Completion Source укажите Custom (OpenAI-compatible).
2. Base URL: В поле Custom Endpoint (Base URL) введите https://tavernapi.com/v1 без косой черты и без /chat/completions на конце.
   • Веб-приложения (JanitorAI): Браузерные интерфейсы, которые просят полный адрес прокси в поле Proxy URL, — исключение: для них указывайте https://tavernapi.com/v1/chat/completions.
   • Нативный реверс-прокси в SillyTavern: Если вы подключаетесь через нативные источники SillyTavern вместо Custom, укажите в поле Proxy Server URL адрес https://tavernapi.com/v1 для источника Claude или https://tavernapi.com для источника Google AI Studio.
3. API-ключ: Вставьте вашу полную строку sk-tav-... в поле Custom API Key (или в поле Proxy Password на нативных источниках) без пробелов в начале и в конце.
4. Подключение и выбор модели: Нажмите Connect и выберите модель из выпадающего списка Available Models (claude-opus-5-5, claude-sonnet-5-5, gemini-4-argon, gemini-3.8-flash или deepseek-v4-pro).
5. Баланс аккаунта: Откройте консоль TavernAPI и убедитесь, что ваш баланс в USD или пробный бонус $0.30 больше нуля.

Как выглядят ошибки TavernAPI в SillyTavern

Когда запрос не удаётся выполнить, TavernAPI возвращает стандартный JSON такой структуры:

{"error": {"message": "...", "type": "...", "code": "..."}}

SillyTavern показывает текст из поля "message" во всплывающем красном уведомлении. Если плашка исчезает слишком быстро, загляните в окно консоли, где запущен сервер SillyTavern (Командная строка на Windows, Termux на Android) — там текст ошибки выводится вместе с HTTP-статусом и полем "code".

Коды ошибок

Найдите нужный HTTP-статус и текст сообщения ниже, чтобы узнать причину сбоя и способ решения.

401 Неверный API-ключ

• Что вы видите: Сообщение Invalid API key, код invalid_api_key. Если ключ не был передан вовсе (поле ключа пустое), сообщение начинается с Missing API key, а код — missing_api_key.
• Почему это происходит: Поле API-ключа пустое, ключ sk-tav-... обрезался при копировании, содержит случайный пробел в начале или конце, был удалён в консоли или взят от другого сервиса (например, OpenRouter или OpenAI).
• Как исправить: Заново скопируйте и вставьте полный ключ sk-tav-... и проверьте, нет ли лишних пробелов. Если полный ключ не сохранился, откройте вкладку API-ключи в консоли и создайте новый ключ (скопируйте его сразу, так как целиком он показывается только один раз).
• Списываются ли средства? Нет.

402 Недостаточно средств на балансе

• Что вы видите: Сообщение Insufficient balance, код insufficient_balance.
• Почему это происходит: Ваш текущий баланс (или пробный бонус) меньше суммы временного резерва, необходимого для запуска запроса. Перед отправкой каждого промпта TavernAPI временно резервирует расчётную стоимость видимых входных токенов плюс полную длину ответа Max Response Length (max_tokens), посчитанную по тарифу выходных токенов модели. Как только генерация ответа завершается, TavernAPI списывает стоимость только реально потраченных токенов и сразу же разблокирует остаток резерва. Из-за такой преавторизации ошибка 402 может появиться, даже когда на счету ещё есть средства — особенно если ползунок Max Response Length выкручен очень высоко или вы вызываете более дорогую модель вроде claude-opus-5-5.
• Как исправить:
  1. Откройте AI Response Configuration (значок с ползунками в SillyTavern) и уменьшите Max Response Length до разумного значения (например, 1024 или 2048 токенов), чтобы снизить сумму предварительного резерва.
  2. Переключитесь в выпадающем списке на более экономную модель, например gemini-3.8-flash или deepseek-v4-pro (см. тарифы на модели).
  3. Либо пополните баланс на вкладке Пополнение в консоли.
• Списываются ли средства? Нет.

403 Ограничение пробного баланса или закрытый пресет

• Что вы видите: Одно из трёх сообщений и кодов 403:
  • Ограничение модели на пробном балансе: Сообщение Model "<id>" is not available with trial credit. Add credit to unlock it., код trial_restricted.
  • Закрытый пакет пресетов: Сообщение "<preset pack name>" is not included in your account. See https://tavernapi.com/console/presets (или This preset is currently unavailable), код preset_locked.
  • Статус аккаунта: Сообщение Account suspended, код account_banned.
• Почему это происходит:
  • trial_restricted: Бесплатный пробный баланс $0.30 работает только с gemini-4-argon и gemini-3.8-flash. Запрос к claude-opus-5-5, claude-sonnet-5-5 или deepseek-v4-pro на аккаунте только с пробным балансом вызывает эту ошибку.
  • preset_locked: Ваш активный пресет в SillyTavern содержит метки [[tav:...]] из уровня пресетов, который ещё не открыт на вашем аккаунте.
  • account_banned: Аккаунт заблокирован (см. Правила допустимого использования).
• Как исправить:
  • Для trial_restricted: Выберите gemini-4-argon или gemini-3.8-flash в списке моделей SillyTavern либо пополните счёт в консоли, чтобы открыть доступ ко всем моделям.
  • Для preset_locked: Переключитесь на свой локальный пресет в SillyTavern, отключите закрытые блоки [[tav:...]] в Prompt Manager или разблокируйте пресет на странице https://tavernapi.com/console/presets. Пресет Standard открывается с первым пополнением; пресет Pro открывается разовой покупкой за $4.99, активным пакетом средств за $19 или $39 либо при достижении $25 общей суммы пополнений (см. как работают пресеты TavernAPI).
  • Для account_banned: Напишите в поддержку и укажите email вашего аккаунта.
• Списываются ли средства? Нет.

404 Модель недоступна

• Что вы видите: Сообщение Model "<id>" is not available, код model_not_found.
• Почему это происходит: В ID модели в запросе допущена опечатка, остался старый идентификатор от другого провайдера (например, anthropic/claude-... из OpenRouter или старый суффикс -story) либо модель временно отключена.
• Как исправить: Нажмите Connect в SillyTavern, чтобы обновить выпадающий список моделей, и выберите модель из списка. Если вы вводите ID модели вручную (например, в JanitorAI), укажите один из пяти точных идентификаторов:
  • claude-opus-5-5
  • claude-sonnet-5-5
  • gemini-4-argon
  • gemini-3.8-flash
  • deepseek-v4-pro
• Списываются ли средства? Нет.

404 Не найдено (неверный URL)

• Что вы видите: Сообщение Not found, код not_found.
• Почему это происходит: Указан неверный путь в URL. Чаще всего /v1 случайно прописан дважды (https://tavernapi.com/v1/v1) или в поле Custom Endpoint в SillyTavern вставили хвост /chat/completions (хотя SillyTavern подставляет /chat/completions сам). Если же /v1 пропущен совсем (https://tavernapi.com), запрос попадает на веб-сайт вместо API и возвращает обычную веб-страницу 404 вместо JSON-ошибки — лечится это точно так же.
• Как исправить: Замените адрес эндпоинта на точный URL для вашего интерфейса из раздела Проверьте в первую очередь:

• Списываются ли средства? Нет.

400 Некорректный запрос

• Что вы видите: Одно из трёх сообщений и кодов 400:
  • model is required (код model_required)
  • messages must be a non-empty array (код messages_required)
  • Unknown preset block [[tav:...]]. Download the latest preset from https://tavernapi.com/console/presets (код preset_block_unknown)
• Почему это происходит:
  • model_required: Перед отправкой сообщения не была выбрана модель.
  • messages_required: В исходящем запросе оказался пустой массив сообщений (например, пустой промпт либо скрипт регулярного выражения или расширения удалил все сообщения).
  • preset_block_unknown: Ваш локальный файл пресета устарел относительно текущей версии на сервере либо метка [[tav:...]] была отредактирована вручную.
• Как исправить:
  • Для model_required нажмите Connect в SillyTavern и выберите модель из выпадающего списка.
  • Для messages_required убедитесь, что в чате есть хотя бы одно сообщение, и проверьте расширения, изменяющие промпт.
  • Для preset_block_unknown скачайте свежий JSON-файл пресета со страницы https://tavernapi.com/console/presets и заново импортируйте его в SillyTavern.
• Списываются ли средства? Нет.

429 Слишком много запросов или перегрузка провайдера

• Что вы видите: Сообщение Upstream error (429), тип rate_limit_error, код upstream_error.
• Почему это происходит: Вы либо отправили слишком много запросов одновременно (например, несколько раз подряд нажали перегенерацию, пока предыдущий ответ ещё создаётся), либо вышестоящий провайдер модели сейчас перегружен. Когда один из маршрутов упирается в лимит нагрузки, TavernAPI сначала автоматически пробует резервные маршруты, прежде чем вернуть 429.
• Как исправить: Подождите несколько секунд и сделайте свайп или перегенерируйте ответ.
• Списываются ли средства? Нет — если ответ не был сгенерирован, средства не списываются.

5xx Ошибки сервера

• Что вы видите:
  • HTTP 502: Сообщение Upstream error (502), код upstream_error
  • HTTP 503: Сообщение No upstream route is configured for this model, код no_route
  • HTTP 500: Код вида preset_... (например, preset_block_error)
• Почему это происходит:
  • Upstream error (502) (upstream_error): Сбой на стороне вышестоящего провайдера модели или обрыв сетевого соединения во время выполнения запроса.
  • No upstream route is configured for this model (503, no_route): Модель временно недоступна по всем настроенным маршрутам провайдера.
  • Коды 500 preset_... (например, preset_block_error): На сервере произошла ошибка при развёртывании защищённого блока пресета.
• Как исправить:
  • Для 502 (upstream_error): Подождите несколько секунд и сделайте свайп или перегенерируйте ответ.
  • Для 503 (no_route): Переключитесь на другую модель в выпадающем списке, пока маршрут восстанавливается.
  • Для 500 (preset_block_error): Попробуйте отправить сообщение в том же чате без пресета TavernAPI (или временно отключив защищённые блоки [[tav:...]]), чтобы убедиться, что сама генерация работает, а затем напишите в поддержку, указав примерное время и ID модели.
• Списываются ли средства? Если сбой у провайдера произошёл до появления текста ответа, зарезервированная сумма возвращается полностью. Если соединение оборвалось посреди ответа после начала потоковой передачи, вы платите только за те токены, которые успели сгенерироваться.

Проблемы без кода ошибки

Иногда SillyTavern не показывает красную плашку с кодом HTTP-ошибки, но в окне чата всё равно что-то работает не так.

Индикатор Connect остаётся красным или список моделей пуст

Если после нажатия Connect в SillyTavern индикатор статуса остаётся красным или выпадающий список Available Models пустует:

1. Проверьте источник, Base URL и API-ключ по чек-листу из раздела Проверьте в первую очередь.
2. Убедитесь, что адрес начинается с https:// (а не http://) и не содержит пробелов перед https:// или после /v1.
3. Если вы подключаетесь через нативный источник Claude или Google AI Studio в SillyTavern, проверьте, что вы развернули блок Reverse Proxy (реверс-прокси) и вставили ключ sk-tav-... именно в поле Proxy Password, а не в верхнее поле для прямого ключа провайдера. Подробное описание всех полей есть в инструкции по настройке SillyTavern.

Ответы приходят пустыми или обрываются на полуслове

Если реплика персонажа обрывается на середине фразы или приходит совершенно пустой:

• Слишком низкое значение Max Response Length: Генерация ответа останавливается, как только упирается в лимит Max Response Length (max_tokens) на вкладке AI Response Configuration в SillyTavern. Кроме того, думающие модели тратят часть этого бюджета токенов на внутренние размышления перед тем, как начать писать видимый текст ответа. Если в Max Response Length выставлено совсем маленькое число (например, 250 или 400), модель может потратить весь лимит на размышления и оставить сам ответ пустым. Увеличьте Max Response Length (например, до 1024–2048 токенов) и перегенерируйте ответ.
• Фильтры безопасности провайдера: Штатные фильтры безопасности самого провайдера модели также могут досрочно прервать ответ или вернуть пустое сообщение, если промпт вызвал срабатывание их классификатора.

Ответы игнорируют пресет или в тексте видны метки [[tav:...]]

Защищённые метки пресетов ([[tav:...]]) разворачиваются только тогда, когда запрос проходит через сервер TavernAPI. Если ответы не учитывают правила пресета или в чате видны необработанные строки [[tav:...]]:

1. Откройте API Connections (значок вилки) и убедитесь, что активное подключение указывает на https://tavernapi.com/v1, а не на другого провайдера, где вы могли случайно оставить включённым пресет TavernAPI.
2. Откройте AI Response Configuration (значок с ползунками) и проверьте, что в списке Chat Completion Presets выбран пресет TavernAPI, а основные блоки промпта включены.
3. После обновлений пресета заново скачайте JSON-файл со страницы https://tavernapi.com/console/presets и импортируйте его в SillyTavern, чтобы локальный файл совпадал с серверной версией. Подробнее читайте в руководстве о том, как работают пресеты TavernAPI.

Расход выше ожидаемого

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

• Первое сообщение после перерыва: Провайдеры моделей хранят закэшированный префикс лишь несколько минут бездействия. Первый ход после долгой паузы заново создаёт кэш, поэтому обходится заметно дороже, а следующие за ним реплики снова идут по льготному тарифу чтения из кэша.
• Редактирование ранних сообщений или изменение шапки промпта: Изменение или удаление старых реплик, переключение пресета посреди чата или размещение случайных макросов ({{random}}, {{roll}}) в начале промпта меняет префикс и заставляет перезаписывать кэш заново.
• Огромный неочищенный контекст: Чат, разросшийся за 100k токенов, на каждом ходе стоит дороже, чем чат на 20k токенов, даже при работающем кэшировании.

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

Проблемы с пополнением и оплатой

Криптопополнения в TavernAPI (через вкладку Пополнение → Перейти к оплате или Оплатить криптой) проходят через платёжный шлюз NOWPayments целыми суммами в долларах от $6 до $500 (см. как оплатить криптовалютой). В консоли в разделе История операций у каждого криптозаказа отображается один из пяти статусов: «Ожидание» (Pending), «Частично оплачено» (Partially paid), «Оплачен» (Paid), «Истёк» (Expired) или «Ошибка» (Failed).

На счёт пришло меньше суммы заказа

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

• Статус заказа меняется на «Частично оплачено» (Partially paid), и мы автоматически зачисляем на баланс фактически дошедшую часть суммы в соответствующей пропорции.
• Чтобы докинуть недостающий остаток, создайте новый заказ на странице Пополнение в консоли.
• Не отправляйте второй перевод на старый адрес кошелька, если об этом вас прямо не попросила поддержка.

Заказ получил статус «Истёк» (Expired)

Неоплаченные криптозаказы автоматически закрываются через 1 час и переходят в статус «Истёк» (Expired). Если вы уже отправили перевод и транзакция дойдёт в блокчейне после истечения этого часового окна, средства всё равно зачислятся на ваш баланс автоматически.

Пополнение ещё не зачислилось

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

Если примерно через 30 минут ничего не изменилось, напишите в поддержку и укажите:

• Хэш транзакции (TXID)
• Монету и сеть, которые вы использовали
• Отправленную сумму
• Email вашего аккаунта TavernAPI

Я отправил больше суммы заказа

Если сумма перевода превышает сумму счёта, автоматически зачисляется только номинал самого заказа, а переплата сама по себе на баланс не добавляется. Напишите в поддержку и пришлите хэш транзакции (TXID) и email вашего аккаунта, чтобы мы проверили платёж и начислили разницу на ваш баланс.

Я выбрал не ту сеть или монету

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

Проблема не решилась?

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

• При ошибках API или пресетов: email вашего аккаунта TavernAPI, ID модели (claude-opus-5-5, claude-sonnet-5-5, gemini-4-argon, gemini-3.8-flash или deepseek-v4-pro), примерное время ошибки (с указанием часового пояса), HTTP-статус и code ошибки, а также название пакета пресетов, если вы его использовали.
• При проблемах с оплатой: email вашего аккаунта, хэш транзакции (TXID), монету и сеть, а также отправленную сумму.