Бот Uncensored Endpoint в Telegram: создание на Python
Чтобы создать бота для Telegram без цензуры, вам понадобятся три компонента: токен бота от BotFather, API-ключ и около 80 строк кода на Python, которые передают каждое сообщение Telegram в маршрут chat completions. Это руководство даёт полный код, а затем добавляет память, потоковую передачу и обработку лимитов.
Ключевые моменты
- Бот использует python-telegram-bot для Telegram и стандартный SDK OpenAI для модели.
- Храните короткую историю для каждого чата и обрезайте её, чтобы каждый запрос оставался небольшим и недорогим.
- Используйте потоковую передачу, редактируя одно сообщение примерно раз в секунду, а не на каждый токен.
- Ограничьте параллельные запросы к модели значением 8 с помощью семафора и используйте повторные запросы при ответе 429.

Что вы создаёте
Задача бота одна: взять текстовое сообщение из чата Telegram, добавить его в историю этого чата, отправить историю модели uncensored и отправить ответ обратно. У каждого чата Telegram своя память, поэтому два человека, общающихся с ботом, никогда не видят контекст друг друга.
Готовый проект — это один файл, состоящий из следующих частей:
- Клиент для API, использующий SDK OpenAI, настроенный на
https://api.uncensoredendpoint.com/v1. - Словарь историй чатов, обрезанный так, чтобы он никогда не рос без ограничений.
- Обработчик сообщений, который потоково передаёт ответ, редактируя одно сообщение Telegram.
- Семафор, который не даёт превысить 8 одновременных запросов, разрешённых полным ключом.
Ничто здесь не требует базы данных. При перезапуске бота истории сбрасываются, что нормально для первой версии. В следующем разделе рассказано, куда добавить сохранение данных.
Предварительные требования
Вам нужен Python 3.10 или новее и два набора учётных данных.
- Токен бота Telegram. Откройте чат с BotFather в Telegram, отправьте команду для создания нового бота, выберите имя и имя пользователя и скопируйте возвращённый токен. Относитесь к токену как к паролю.
- API-ключ. Зарегистрируйтесь на странице ключей через Google или по электронной почте и паролю. Новые пользователи могут одним кликом получить $0,50 пробного баланса, чего хватит, чтобы многократно протестировать этого бота. Пробный ключ позволяет выполнять 2 параллельных запроса и до 60 запросов в минуту.
Установите две библиотеки и экспортируйте секреты как переменные окружения, чтобы они никогда не попали в исходный код:
pip install "python-telegram-bot>=20" openai
export TELEGRAM_TOKEN="123456:your-bot-token"
export API_KEY="your-api-key"
Если позже вы перейдёте от пробного режима к реальной нагрузке, кредит поступает в виде пополнения криптовалютой (USDT в сети TRC20, USDC в сети Base) на сумму от $20 до $500. На странице с ценами указаны уровни бонусов.
Минимально рабочий бот
Начните с самой маленькой версии, которая отвечает на сообщения. В ней пока нет потоковой передачи и обрезки, чтобы вы могли сначала проверить подключение.
import os
from collections import defaultdict
from openai import AsyncOpenAI
from telegram import Update
from telegram.ext import ApplicationBuilder, ContextTypes, MessageHandler, filters
client = AsyncOpenAI(
base_url="https://api.uncensoredendpoint.com/v1",
api_key=os.environ["API_KEY"],
max_retries=3,
)
SYSTEM = "You are a friendly, direct assistant. Keep answers short unless asked for detail."
history = defaultdict(list) # chat_id -> list of messages
async def on_text(update: Update, context: ContextTypes.DEFAULT_TYPE):
chat_id = update.effective_chat.id
history[chat_id].append({"role": "user", "content": update.message.text})
resp = await client.chat.completions.create(
model="uncensored",
messages=[{"role": "system", "content": SYSTEM}] + history[chat_id],
temperature=0.8,
)
answer = resp.choices[0].message.content
history[chat_id].append({"role": "assistant", "content": answer})
await update.message.reply_text(answer[:4000])
app = ApplicationBuilder().token(os.environ["TELEGRAM_TOKEN"]).build()
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, on_text))
app.run_polling()
Запустите его, откройте бота в Telegram и напишите привет. Срез answer[:4000] существует, потому что Telegram ограничивает одно сообщение 4096 символами. Длинный ответ модели иначе привёл бы к ошибке отправки. Позже вы сможете разбивать длинные ответы на несколько сообщений вместо их обрезки.
SDK OpenAI самостоятельно повторяет некоторые запросы при ошибках, включая ответы 429, с короткой задержкой. Установка max_retries=3 даёт небольшой запас прочности без написания цикла повторных попыток.
Память, которая не растёт бесконечно
Запросы chat completions не хранят состояние. Модель знает только то, что вы отправляете в каждом запросе, поэтому бот отправляет историю заново на каждом шаге. Именно поэтому неограниченная история — главная ловушка затрат и задержек. Контекстное окно составляет 100 000 токенов, что много, но вы платите за каждый входной токен на каждом шаге, и большинству чат-ботов далеко не так много нужно.
Простая политика работает хорошо: сохраняйте системный промпт и храните только последние N сообщений. Двадцать сообщений, по десять от пользователя и от бота, подходят для неформального общения.
MAX_MESSAGES = 20
def remember(chat_id, role, content):
h = history[chat_id]
h.append({"role": role, "content": content})
if len(h) > MAX_MESSAGES:
del h[: len(h) - MAX_MESSAGES]
Обрезка в произвольной точке может оставить историю, начинающуюся с сообщения ассистента. Для этой модели это безвредно, но если вы хотите аккуратности, удалите ещё одно сообщение, если первое оставшееся не от пользователя.
Для персонажей или длинных историй, где модели нужно помнить факты из начала, обрезка их теряет. Два распространённых исправления — закрепленная заметка и скользящее резюме. Закрепленная заметка — это короткий блок фактов, который вы храните в системном промпте, например имена и текущая сцена. Скользящее резюме просит модель каждые тридцать сообщений сжать старую половину истории в абзац, который вы затем сохраняете вместо этих сообщений.
Добавьте команду /reset, которая очищает history[chat_id]. Людям нравится чистый лист, и это ничего вам не стоит.
Потоковая передача ответа путём редактирования одного сообщения
Ожидание десяти секунд для длинного ответа кажется медленным в чат-приложении. Потоковая передача позволяет ответу расти на экране. Telegram не принимает сообщение токен за токеном, поэтому трюк в том, чтобы отправить заполнитель, а затем редактировать его по мере поступления текста. Редактируйте не чаще одного раза в секунду. Telegram применяет свои собственные лимиты на флуд к ботам, и частое редактирование на каждый токен приведёт к ограничению скорости и замедлению потока.
import time
async def stream_answer(update, chat_id):
msg = await update.message.reply_text("...")
stream = await client.chat.completions.create(
model="uncensored",
messages=[{"role": "system", "content": SYSTEM}] + history[chat_id],
stream=True,
)
text, last_edit = "", 0.0
async for chunk in stream:
if not chunk.choices:
continue
piece = chunk.choices[0].delta.content or ""
text += piece
if time.monotonic() - last_edit > 1.0 and text.strip():
await msg.edit_text(text[:4000])
last_edit = time.monotonic()
if text.strip():
await msg.edit_text(text[:4000])
return text
Важны две детали. Во-первых, всегда делайте финальное редактирование после цикла, так как последние фрагменты обычно поступают между редактированиями по таймеру. Во-вторых, Telegram отклоняет редактирование, которое не меняет текст, поэтому пропускайте вызов, если нет новых данных. Библиотека вызывает ошибку для этого случая, и try/except вокруг редактирования сохраняет поток живым.
Помните, что потоковый запрос удерживает слот параллельности до конца потока. Бот с множеством чатов, общающихся одновременно, достигнет лимита раньше с потоковой передачей, чем без неё, что приводит к следующему разделу.
Соблюдение лимитов запросов
Полный ключ позволяет 8 одновременных запросов и 300 запросов в минуту. Пробный ключ позволяет 2 и 60. Активный групповой чат может легко превысить 2 одновременно, поэтому настройте лимит в зависимости от используемого ключа.
Самая чистая защита — семафор вокруг вызова модели. Запросы, превышающие лимит, ждут в очереди внутри вашего процесса, а не отскакивают от API:
import asyncio
slots = asyncio.Semaphore(8) # use 2 with a trial key
async def on_text(update, context):
chat_id = update.effective_chat.id
remember(chat_id, "user", update.message.text)
async with slots:
text = await stream_answer(update, chat_id)
remember(chat_id, "assistant", text)
Если вы всё равно получаете HTTP 429, прочитайте код ошибки. concurrency означает слишком много вызовов одновременно, rate_limited означает слишком много в минуту, а 429 с Retry-After: 5 означает временную перегрузку; подождите пять секунд. Повторные попытки SDK обрабатывают большинство из них. Неудачные или отклонённые запросы не оплачиваются, поэтому повторные попытки не увеличивают счёт.
Ещё одна защита — контроль темпа на пользователя. Если один человек отправляет десять сообщений за десять секунд, сериализуйте их запросы с блокировкой на чат, чтобы ответы приходили по порядку и один чат не мог использовать все восемь слотов.
Персона, правила и групповые чаты
Системный промпт определяет характер бота. Пишите его как краткое описание: кто бот, как он говорит, какой длины должны быть ответы и чего он должен избегать. Для ролевого бота или бота-компаньона для взрослых опишите сеттинг и тон в нескольких строках, а остальное предоставьте пользователю. Конкретные промпты лучше длинных; модель лучше следует чёткому описанию из пяти строк, чем странице правил.
Некоторые правила находятся вне промпта. Модель отвечает без отказов по контенту для законного использования взрослыми, но сексуальный контент с участием несовершеннолетних всегда запрещён, и вы должны обеспечивать это на своей стороне. Если ваш бот открыт для публики, укажите это в его описании, добавьте уведомление о возрасте в стартовое сообщение и помните, что у Telegram есть свои условия для ботов, которые вы также обязаны соблюдать. Разговоры ваших пользователей идут в API, а промпты не используются для обучения; сообщите пользователям, что хранит ваш бот.
В групповых чатах не отвечайте на каждое сообщение. Отвечайте только когда бот упомянут или когда кто-то отвечает на одно из его сообщений, и игнорируйте сообщения, отправленные другими ботами. В python-telegram-bot вы можете проверить update.message.entities на упоминание или сравнить update.message.reply_to_message.from_user.id с собственным ID бота.
Когда что-то идёт не так, логируйте заголовок ответа X-Request-Id для каждого вызова; вы можете прочитать его через интерфейс сырого ответа SDK. На странице поддержки можно задать вопрос о конкретном запросе.
Запуск в реальных условиях
Опрос, используемый выше, подходит для небольшого бота: процесс опрашивает Telegram о новых сообщениях в цикле и не требует публичного адреса. Запустите его под systemd или в контейнере с автоматическим перезапуском и храните два секрета в переменных окружения unit-файла или хранилище секретов. Настройка веб-хука снижает нагрузку в простое, но требует HTTPS и публичный URL, поэтому начните с опроса.
Оцените расходы до приглашения пользователей. API стоит $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Типичный обмен с обрезанной историей из 2 000 входных токенов и 500 выходных токенов стоит 2 000 x $0,15 / 1 млн = $0,0003 за входные данные плюс 500 x $0,50 / 1 млн = $0,00025 за выходные данные, что составляет $0,00055. Тысяча обменов стоит $0,55. Если чат вырастает до 10 000 входных токенов на обмен, одна только часть за входные данные становится $0,0015, поэтому обрезка истории быстро окупается.
Если нужна сохранность состояния, храните историю каждого чата в виде JSON в SQLite или Redis, загружайте её при первом сообщении после перезапуска и сохраняйте после каждого ответа. Если бот публичный, установите дневный лимит сообщений на пользователя, чтобы один активный пользователь не исчерпал баланс. В документации API перечислены все параметры, которые можно настроить, а в чек-листе для продакшена описана ротация ключей и мониторинг заголовка баланса.
Дополнительные руководства
Вопросы и ответы
Какую библиотеку использовать для Telegram?
Любая библиотека работает, потому что со стороны модели это обычный HTTP API. В этом руководстве используется python-telegram-bot версии 20 или новее, который является асинхронным и хорошо сочетается с асинхронным клиентом OpenAI.
Почему бот отвечает сам себе или всем в группе?
В группах ограничьте обработчик сообщениями, где бот упомянут или на которые он отвечает, и игнорируйте сообщения от ботов. Иначе каждое сообщение в группе будет вызывать запрос к модели.
Сколько стоит разговор с ботом?
Короткий обмен 2 000 входными токенами и 500 выходными токенами стоит $0,00055, поэтому тысяча таких обменов стоит $0,55. Длинные истории стоят дороже, потому что они отправляются заново при каждом обмене.
Можно ли использовать бота для взрослой ролевой игры?
Модель настроена так, чтобы отвечать без отказов по контенту для законного взрослого использования, и боты для художественной литературы и чата-компаньона являются типичным случаем. Сексуальный контент с участием несовершеннолетних никогда не допускается, а Telegram имеет свои правила, которым вы должны следовать.
Ваш ключ в одном шаге от вас
Создайте аккаунт, скопируйте ключ, измените базовый URL. Вот и вся настройка.