RU ▾
Uncensored Chatbot APIПрямой API-доступ к LLM без цензурыПолучить API-ключ

Uncensored Chatbot APIБезопасность

Учебное пособие по чат-ботам без кода: Open WebUI и другие

Это руководство по чат-ботам без кода позволяет получить рабочий чат-интерфейс для uncensored API, совместимого с OpenAI, без написания приложения. Вы вставляете базовый URL и ключ в инструмент, у которого уже есть окно чата.

Обновлено

Модульные блоки, формирующие окно чата, подключенное к серверу, представляющие настройку чат-бота без кода

Ключевые моменты

  • Любой фронтенд для чата, принимающий пользовательский эндпоинт OpenAI-compatible, может использовать этот API.
  • Вам понадобятся три значения: базовый URL, ваш ключ и ID модели uncensored.
  • Open WebUI и SillyTavern — это два инструмента, поддерживающие пользовательские эндпоинты, а LangChain — следующий шаг, если вы хотите немного кода.
  • Начните с бесплатного пробного баланса, затем пополните его от $20 криптовалютой.

Что означает «без кода» в данном контексте

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

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

Что вам нужно перед началом

Соберите три значения.

  • Базовый URL: https://api.uncensoredchatbotapi.com/v1
  • API-ключ: со страницы API-ключ. Зарегистрируйтесь через Google или по email и паролю, затем получите пробный баланс в один клик. Он даёт кредит на $0,50, действительный в течение 7 дней, один на человека, и не требует привязки карты.
  • Идентификатор модели: uncensored

Аутентификация — это стандартный Bearer-токен, который уже поддерживается каждым инструментом, совместимым с OpenAI. Эндпоинты: POST /v1/chat/completions для чата и GET /v1/models для списка моделей. Инструменты обычно вызывают второй, чтобы заполнить выпадающий список моделей, поэтому, если список пуст, скорее всего, проблема в базовом URL.

Быстрая проверка работоспособности из терминала сэкономит время:

curl https://api.uncensoredchatbotapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

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

Вариант 1: Open WebUI

Open WebUI — это автономный интерфейс чата, поддерживающий подключения, совместимые с OpenAI. Если у вас установлен Docker, одна команда запускает его с предварительно настроенным эндпоинтом:

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.uncensoredchatbotapi.com/v1 \
  -e OPENAI_API_KEY=YOUR_KEY \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Откройте http://localhost:3000, создайте локальную учетную запись администратора и выберите uncensored из выпадающего списка моделей. Если вы предпочитаете настроить его через интерфейс, перейдите в настройки администратора, откройте раздел подключений, добавьте подключение OpenAI и вставьте туда базовый URL и ключ. Названия в меню могут отличаться в разных версиях, поэтому проверьте документацию проекта, если название не совпадает.

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

Вариант 2: SillyTavern для персонажей и ролевых игр

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

  1. Установите SillyTavern, следуя его инструкциям, и запустите его.
  2. Откройте панель подключений API и выберите тип завершения чата.
  3. Выберите пользовательский источник, совместимый с OpenAI.
  4. Вставьте https://api.uncensoredchatbotapi.com/v1 как эндпоинт и ваш ключ как API-ключ.
  5. Введите uncensored как ID модели, затем нажмите «Подключить».

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

Вариант 3: LangChain за пять строк

Если вы можете запустить один короткий скрипт на Python, LangChain дает вам мост к шаблонам, памяти и агентам в будущем. Это считается low-code, а не no-code, но требует почти никаких усилий:

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="uncensored",
    base_url="https://api.uncensoredchatbotapi.com/v1",
    api_key="YOUR_KEY",
)
print(llm.invoke("Introduce yourself as a friendly guide in one sentence.").content)

Установите его с помощью pip install langchain-openai. Отсюда вы можете добавить шаблон промпта, потоковую передачу токенов или привязку инструментов. Вызов функций и JSON-режим поддерживаются API, поэтому цепочки в стиле агентов работают. Параметры, такие как temperature, top_p, stop и seed, передаются, поэтому вы можете настраивать креативность так же, как и в оригинальном пакете OpenAI.

Написание системного промпта без кода

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

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

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

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

Какой вариант выбрать

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

Ни один из этих инструментов не требует платного плана от этого сервиса. Вы пополняете баланс только когда заканчивается пробный период, и вы платите только за использованные токены. Если вы попробуете один инструмент и он вам не подойдет, переключитесь на другой без изменения учетной записи, так как базовый URL, ключ и ID модели остаются одинаковыми везде.

Стоимость, лимиты и распространенные проблемы

Вы платите $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов из предоплаченного баланса, без подписки. Разговорная сессия из 20 сообщений, в среднем 1 000 входных токенов и 250 выходных токенов каждое, использует 20 000 входных и 5 000 выходных токенов. Это стоит $0,003 плюс $0,0025, то есть $0,0055. По этой ставке пробный баланс в $0,50 покрывает около 90 сессий. Сбойные или отклоненные запросы не оплачиваются.

Когда пробного баланса перестанет хватать, пополнения доступны от $20 до $500, с +5% от $50, +10% от $100 и +15% от $200, оплачиваемые в USDT на TRC20 или USDC на Base. Кредит не сгорает. На странице цены показаны все детали.

Если что-то сломалось

  • Пустой список моделей или ошибка подключения: проверьте, что URL заканчивается на /v1 без дополнительного пути, и что ключ не содержит лишних пробелов.
  • 401: ключ неверный или отсутствует.
  • 429 с кодом concurrency: пробный ключ позволяет выполнять 2 параллельных запроса и до 60 в минуту. Закройте лишние вкладки или дождитесь завершения потоковых запросов, так как потоковый запрос удерживает свой слот до завершения.
  • 429 с кодом rate_limited: вы превысили лимит на минуту. Подождите минуту. Полный ключ позволяет выполнять 8 параллельных запросов и до 300 в минуту.
  • 429 с Retry-After: 5: временная перегрузка. Повторите попытку через пять секунд.

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

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

Нужно ли уметь программировать?

Нет, если вы используете готовое чат-приложение, такое как Open WebUI или SillyTavern. Вы вставляете базовый URL, свой API-ключ и ID модели uncensored в настройки подключения.

Могу ли я разместить одно из этих инструментов на своём публичном сайте?

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

Какой ID модели ввести?

Введите uncensored. Вы можете подтвердить это, вызвав GET /v1/models с вашим ключом.

Можно ли попробовать бесплатно?

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

Ваш ключ — всего в одной форме регистрации регистрации регистрации

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

Получить API-ключЧитать документацию