RU ▾
Получить API-ключ

Обновлено

API-ключ DeepSeek в SillyTavern: подключение нашего API

SillyTavern может работать с любым endpoint, совместимым с OpenAI, через источник Custom. Это руководство показывает поля для заполнения, разумные настройки контекста для долгой ролевой игры и стоимость каждого чата.

Иллюстрация сцены с парящими масками, подключёнными к серверу, представляющая ролевой чат с API в SillyTavern

Быстрая настройка

Для настройки deepseek api key sillytavern сначала одно уточнение. Ключ, выданный собственной платформой DeepSeek, предназначен для эндпоинта DeepSeek. Ключ, который вы получаете на этом сайте, принадлежит отдельному сервису: независимому API, совместимому с OpenAI, работающему на одной модели с открытыми весами, настроенной на ответы без отказов по контенту для законного использования взрослыми. Это не официальный API DeepSeek, поэтому используйте ключ этого сайта только с базовым URL этого сайта.

Значения, которые нужно ввести в SillyTavern:

  • Источник: Chat Completion, затем Custom (совместимый с OpenAI)
  • Пользовательский эндпоинт (базовый URL): https://api.deepseekapikey.com/v1
  • API-ключ: ключ из вашего аккаунта
  • Идентификатор модели: uncensored

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

Пошагово в интерфейсе

  1. Получите ключ. Зарегистрируйтесь на странице API-ключа через Google или по электронной почте и паролю. Новые пользователи могут получить $0,50 пробного баланса в один клик, действительный в течение 7 дней, один на человека, без карты.
  2. Откройте панель API-подключения. В SillyTavern нажмите значок розетки в верхней части, чтобы открыть «API-подключения».
  3. Выберите тип API. Выберите Chat Completion в выпадающем списке API. Режимы завершения текста предназначены для бэкендов, принимающих сырые промпты; этот API использует сообщения чата.
  4. Выберите источник. В списке источников Chat Completion Source выберите Custom (совместимый с OpenAI).
  5. Введите эндпоинт. Вставьте https://api.deepseekapikey.com/v1 в поле пользовательского эндпоинта. SillyTavern самостоятельно добавляет путь к чат-завершениям, поэтому его не нужно указывать. Если позже вы получите ошибку 404, попробуйте указать полный путь как запасной вариант.
  6. Введите ключ. Вставьте ключ в поле пользовательского API-ключа.
  7. Введите модель. Введите uncensored в поле идентификатора модели. Если выпадающий список моделей загружается из эндпоинта GET /v1/models, вы можете выбрать его оттуда.
  8. Подключение. Нажмите «Подключение». Зелёный статус и имя модели означают, что запрос выполнен успешно. Отправьте сообщение персонажу, чтобы подтвердить это.

Если подключение не удалось, протестируйте вне SillyTavern в терминале. Это изолирует проблему:

curl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Reply with the word ready."}], "max_tokens": 10}'

Обычный ответ JSON означает, что ключ и URL действительны, а проблема в полях SillyTavern. В быстром старте приведено больше примеров.

Размер контекста и длина ответа

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

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

Практичный способ выбора:

  • 8 000–16 000 токенов: короткие сцены и быстрые чаты. Дешево и быстро.
  • 30 000–50 000 токенов: длинная история с детальной карточкой персонажа и книгой лора. Хорошо для большинства пользователей.
  • До 100 000 токенов: большие книги лора или очень длинные непрерывные истории. Оставьте запас, чтобы промпт плюс ответ оставались в пределах окна.

Для длины ответа установите «Максимальную длину ответа» в 300–600 токенов для обычного ответа в ролевой игре. Параметр max tokens в API необязателен, но SillyTavern отправляет значение, а лимит предотвращает чрезмерное увеличение счёта из-за слишком длинного ответа. Включите опцию потоковой передачи, чтобы текст появлялся по мере генерации; API поддерживает серверные события с stream: true.

Передача штрафов и значений сэмплирования работает так, как предполагает интерфейс. Temperature, Top P, frequency penalty и presence penalty отправляются модели, а также передаются последовательности остановки и фиксированный seed. Начните с температуры около 0,8 и корректируйте: уменьшайте, если персонаж теряет нить фактов, увеличивайте, если ответы кажутся повторяющимися.

Стоимость ролевой игры

Цена составляет $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов. Входные данные доминируют из-за отправки истории заново. Примеры с ответом на 400 токенов каждый:

Размер промптаСтоимость входных данныхСтоимость выхода (400 токенов)За сообщение100 сообщений
8 000 токенов$0,0012$0,0002$0,0014$0,14
20 000 токенов$0,0030$0,0002$0,0032$0,32
50 000 токенов$0,0075$0,0002$0,0077$0,77
100 000 токенов$0,0150$0,0002$0,0152$1,52

Проверьте одну строку: 20 000 / 1 000 000 x $0,15 = $0,003, и 400 / 1 000 000 x $0,50 = $0,0002, что дает $0,0032. При таком размере пробный баланс $0,50 покрывает примерно 156 сообщений. Ошибочные или отклоненные запросы не оплачиваются, поэтому повторные попытки после ошибки не увеличивают счет. Свайпы и регенерации считаются, так как каждый из них — новый завершенный запрос.

Баланс предоплаченный, не сгорает, подписка отсутствует. Пополняйте на любую целую сумму от $20 до $500, с бонусом +5% от $50, +10% от $100 и +15% от $200. Например, $100 превращаются в $110. Вы можете оплатить криптовалютой (USDT в сети TRC20, USDC в сети Base). Текущий список доступен на странице с ценами.

Групповые чаты, свайпы и лимиты запросов

SillyTavern может отправлять несколько запросов близко друг к другу: групповые чаты, где несколько персонажей отвечают последовательно, свайпы и расширения, которые суммируют или генерируют побочный контент. Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту. Пробный ключ позволяет 2 параллельных и 60 в минуту.

Если вы видите ошибку с кодом concurrency, значит, одновременно выполняется слишком много запросов. Подождите, пока завершится текущая потоковая передача, прежде чем отправлять снова, потому что потоковый запрос удерживает свой слот до конца потока. Ошибка с кодом rate_limited означает превышение лимита запросов в минуту. Ошибка 429 с заголовком Retry-After: 5 — это временная перегрузка, которая быстро проходит.

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

Исправление распространенных проблем

Подключение говорит «неавторизован»

Ключ неверный, содержит пробел в конце или выдан другим сервисом. Ключ, выданный платформой DeepSeek, не работает с этим базовым URL.

Подключение говорит «не найдено»

Проверьте написание эндпоинта. В стандартной настройке он должен заканчиваться на /v1. В некоторых сборках требуется полный путь к чат-завершениям, поэтому, если короткий вариант не сработает, попробуйте https://api.deepseekapikey.com/v1/chat/completions.

Ответы короткие или обрезанные

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

Персонаж забывает предыдущие события

Так работает настройка контекста. Увеличьте её или перенесите ключевые факты в карточку персонажа, персону или запись в лорбуке, чтобы они оставались в каждом промпте.

Ответ отклоняется

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

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

Вопросы и ответы

Могу ли я использовать ключ, выданный DeepSeek, в SillyTavern с этой настройкой?

Нет. Ключи работают только с сервисом, который их выдал. Для ключа DeepSeek используйте собственный эндпоинт DeepSeek; для ключа этого сайта используйте https://api.deepseekapikey.com/v1.

Какой источник выбрать в SillyTavern?

Выберите Chat Completion, затем Custom (совместимый с OpenAI). Введите базовый URL, ваш ключ и идентификатор модели uncensored.

Какой может быть размер контекста?

Окно составляет 100 000 токенов для промпта и ответа вместе. Более высокая настройка стоит дороже за сообщение, так как история отправляется снова на каждом шаге.

Поддерживается ли потоковая передача?

Да. Потоковая передача работает через серверные события (SSE), и вы можете включить её в SillyTavern. Потоковый запрос удерживает слот параллельных запросов до завершения.

Как я могу протестировать это бесплатно?

Новые пользователи могут активировать $0,50 пробного баланса одним нажатием на странице API-ключа после регистрации. Он действует 7 дней и не требует привязки карты.

Ваш ключ — всего в одном шаге

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

Получить API-ключ