Bot Telegram Uncensored Endpoint : créez-le en Python
Pour construire un bot Telegram sur un endpoint sans censure, vous avez besoin de trois éléments : un token de bot obtenu via BotFather, une clé API et environ 80 lignes de Python qui envoient chaque message Telegram à la route de complétion de conversation. Ce guide fournit le code complet, puis ajoute la mémoire, le streaming et la gestion des limites.
Points clés
- Le bot utilise python-telegram-bot pour Telegram et le SDK OpenAI standard pour le modèle.
- Conservez un historique court par conversation et réduisez-le pour que chaque requête reste petite et économique.
- Activez le streaming en modifiant un message environ une fois par seconde, et non à chaque token.
- Limitez les appels parallèles au modèle à 8 à l'aide d'un sémaphore et réessayez les réponses 429.

Ce que vous construisez
Le bot a une seule tâche : prendre un message texte d’une conversation Telegram, l’ajouter à l’historique de cette conversation, envoyer l’historique au modèle uncensored, puis renvoyer la réponse. Chaque conversation Telegram dispose de sa propre mémoire, donc deux personnes parlant au bot ne voient jamais le contexte de l’autre.
Le projet terminé est un fichier unique composé des parties suivantes :
- Un client pour l’API, utilisant le SDK OpenAI pointé vers
https://api.uncensoredendpoint.com/v1. - Un dictionnaire des historiques de conversation, borné pour qu’il ne croisse pas sans limite.
- Un gestionnaire de messages qui diffuse la réponse en modifiant un seul message Telegram.
- Un sémaphore qui vous maintient sous les 8 requêtes simultanées qu’une clé complète permet.
Rien ici n’a besoin d’une base de données. Lorsque le bot redémarre, les historiques sont réinitialisés, ce qui convient pour une première version. Une section ultérieure couvre l’ajout de la persistance.
Prérequis
Vous avez besoin de Python 3.10 ou supérieur et de deux identifiants.
- Un jeton bot Telegram. Ouvrez une conversation avec BotFather dans Telegram, envoyez la commande pour créer un nouveau bot, choisissez un nom et un nom d’utilisateur, puis copiez le jeton qu’il retourne. Traitez le jeton comme un mot de passe.
- Une clé API. Inscrivez-vous sur la page des clés avec Google ou avec e-mail et mot de passe. Les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d'essai en un clic, ce qui suffit pour tester ce bot à de nombreuses reprises. La clé d'essai autorise 2 requêtes simultanées et 60 requêtes par minute.
Installez les deux bibliothèques et exportez les secrets en tant que variables d’environnement pour qu’ils ne finissent jamais dans votre code source :
pip install "python-telegram-bot>=20" openai
export TELEGRAM_TOKEN="123456:your-bot-token"
export API_KEY="your-api-key"
Si vous passez plus tard de l’essai au trafic réel, le crédit provient d’un rechargement par crypto (USDT sur TRC20, USDC sur Base) de $20 à $500. La page des tarifs liste les paliers de bonus.
Un bot minimal fonctionnel
Commencez par la version la plus petite qui répond aux messages. Elle n’a ni streaming ni réduction pour l’instant, afin que vous puissiez d’abord confirmer le câblage.
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()
Exécutez-le, ouvrez votre bot dans Telegram et dites bonjour. La tranche answer[:4000] existe car Telegram limite un message unique à 4 096 caractères. Une longue réponse du modèle ferait autrement échouer l’appel d’envoi. Plus tard, vous pourrez diviser les longues réponses en plusieurs messages au lieu de les couper.
Le SDK OpenAI réessaie automatiquement certains échecs, y compris les réponses 429, avec un délai d'attente court. Définir max_retries=3 vous donne une marge de sécurité sans avoir à écrire une boucle de réessai.
Une mémoire qui ne croît pas indéfiniment
Les complétions de chat sont sans état. Le modèle ne connaît que ce que vous envoyez dans chaque requête, donc le bot renvoie l'historique à chaque tour. C'est pourquoi une histoire non bornée est le principal piège de coût et de latence. La fenêtre de contexte est de 100 000 tokens, ce qui est beaucoup, mais vous payez pour chaque token d'entrée à chaque tour, et la plupart des chat bots n'ont pas besoin de près de cette quantité.
Une politique simple fonctionne bien : conservez le prompt système, et ne gardez que les N derniers messages. Vingt messages, dix de l’utilisateur et dix du bot, conviennent à une conversation informelle.
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]
Couper à un point arbitraire peut laisser un historique commençant par un message de l’assistant. Cela est sans danger pour ce modèle, mais si vous voulez que ce soit propre, supprimez un message de plus lorsque le premier message restant n’est pas de l’utilisateur.
Pour les personnages ou les longs récits où le modèle doit se souvenir de faits anciens, la réduction les fait perdre. Deux correctifs courants sont une note épinglée et un résumé roulant. Une note épinglée est un court bloc de faits que vous conservez dans le prompt système, comme les noms et la scène actuelle. Un résumé roulant demande au modèle, tous les trente messages environ, de compresser la moitié plus ancienne de l’historique en un paragraphe, que vous stockez ensuite à la place de ces messages.
Ajoutez une commande /reset qui efface history[chat_id]. Les utilisateurs apprécient d’avoir une page blanche, et cela ne vous coûte rien.
Le streaming de la réponse en modifiant un message
Attendre dix secondes pour une longue réponse semble lent dans une application de chat. Le streaming permet à la réponse de s'afficher progressivement. Telegram n'accepte pas un token de message par token, donc l'astuce consiste à envoyer un espace réservé, puis à le modifier à mesure que le texte arrive. Modifiez environ une fois par seconde au maximum. Telegram applique ses propres limites de débit aux bots, et multiplier les appels de modification à chaque token vous fait subir une limitation de débit et ralentit le streaming.
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
Deux détails sont importants. Premièrement, faites toujours une modification finale après la boucle, car les derniers morceaux arrivent généralement entre les modifications à intervalles réguliers. Deuxièmement, Telegram rejette une modification qui ne change pas le texte, donc sautez l'appel quand il n'y a rien de nouveau. La bibliothèque lève une erreur pour ce cas, et un try/except autour de la modification maintient le streaming actif.
N’oubliez pas qu’une requête en streaming occupe sa place de concurrence jusqu’à la fin du flux. Un bot avec de nombreuses conversations en même temps atteindra la limite plus tôt avec le streaming qu’avec sans, ce qui mène à la section suivante.
Respecter les limites de débit
Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute. Une clé d’essai permet 2 et 60. Une conversation de groupe active peut facilement dépasser 2 à la fois, donc dimensionnez votre limite en fonction de la clé que vous utilisez.
Le garde le plus propre est un sémaphore autour de l’appel modèle. Les requêtes au-delà du cap attendent dans la file à l’intérieur de votre processus au lieu de rebondir sur l’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)
Si vous obtenez toujours une erreur HTTP 429, lisez le code d’erreur. concurrency signifie trop d’appels à la fois, rate_limited signifie trop par minute, et un 429 avec Retry-After: 5 signifie une surcharge temporaire ; attendez les cinq secondes. Le réessai du SDK gère la plupart de ces cas. Les requêtes échouées ou refusées ne sont pas facturées, donc les réessais n’ajoutent pas à la facture.
Une autre garde est le rythme par utilisateur. Si une seule personne envoie dix messages en dix secondes, sérialisez leurs requêtes avec un verrou par chat pour que les réponses arrivent dans l'ordre et qu'un chat ne puisse pas utiliser les huit emplacements.
Personnalité, règles et chats de groupe
Le prompt système est là où le bot acquiert sa personnalité. Rédigez-le comme une courte fiche : qui est le bot, comment il parle, quelle doit être la longueur des réponses, et tout ce qu’il ne doit pas faire. Pour un bot de jeu de rôle ou de compagnie pour adultes, décrivez le cadre et le ton en quelques lignes et laissez l’utilisateur diriger à partir de là. Des prompts spécifiques battent les longs ; le modèle suit mieux une personnalité claire de cinq lignes qu’une page de règles.
Certaines règles sont en dehors du prompt. Le modèle répond sans refus de contenu pour un usage adulte légal, mais le contenu sexuel impliquant des mineurs n'est jamais autorisé, et vous devez également l’appliquer de votre côté. Si votre bot est ouvert au public, dites-le dans sa description, ajoutez un avis d’âge dans le message de démarrage, et rappelez-vous que Telegram a ses propres conditions pour les bots que vous devez également respecter. Les conversations de vos utilisateurs vont à l’API, et les prompts ne sont pas utilisés pour l’entraînement ; dites à vos utilisateurs ce que votre propre bot stocke.
Dans les chats de groupe, ne répondez pas à chaque message. Répondez uniquement lorsque le bot est mentionné ou lorsque quelqu’un répond à l’un de ses messages, et ignorez les messages envoyés par d’autres bots. Dans python-telegram-bot, vous pouvez vérifier update.message.entities pour une mention ou comparer update.message.reply_to_message.from_user.id avec l’ID propre du bot.
Lorsque quelque chose se passe mal, enregistrez l’en-tête de réponse X-Request-Id pour chaque appel ; vous pouvez le lire via l’interface de réponse brute du SDK. La page de support est l’endroit où demander des informations sur une requête spécifique.
Le lancer en production
Le polling, tel qu’utilisé ci-dessus, convient à un petit bot : le processus demande à Telegram de nouveaux messages dans une boucle et n’a pas besoin d’une adresse publique. Exécutez-le sous systemd ou dans un conteneur avec redémarrage automatique, et conservez les deux secrets dans l’environnement du fichier unité ou dans un magasin de secrets. Une configuration webhook réduit la charge idle, mais nécessite HTTPS et une URL publique, donc commencez par le polling.
Estimez le coût avant d’inviter des personnes. L’API facture 0,15 $ par 1M de tokens d’entrée et 0,50 $ par 1M de tokens de sortie. Un tour typique avec un historique réduit de 2 000 tokens d’entrée et 500 tokens de sortie coûte 2 000 x 0,15 $ / 1M = 0,0003 $ pour l’entrée plus 500 x 0,50 $ / 1M = 0,00025 $ pour la sortie, soit 0,00055 $. Un millier de tours coûtent 0,55 $. Si une conversation atteint 10 000 tokens d’entrée par tour, la partie entrée seule devient 0,0015 $, donc la réduction paie rapidement.
Lorsque vous avez besoin de persistance, stockez l'historique de chaque chat en JSON dans SQLite ou Redis, chargez-le au premier message après un redémarrage, et réécrivez-le après chaque réponse. Ajoutez une limite quotidienne de messages par utilisateur si le bot est public, afin qu'un utilisateur enthousiaste ne puisse pas vider le solde. La documentation de l'API liste tous les paramètres que vous pouvez ajuster, et la liste de contrôle des clés de production couvre le renouvellement des clés et la surveillance de l'en-tête du solde.
Plus de guides
Questions et réponses
Quelle bibliothèque utiliser pour la partie Telegram ?
Toute bibliothèque fonctionne car le côté modèle est une API HTTP standard. Ce guide utilise python-telegram-bot version 20 ou supérieure, qui est asynchrone et s’associe bien au client OpenAI asynchrone.
Pourquoi mon bot répond-il à lui-même ou à tout le monde dans un groupe ?
Dans les groupes, restreignez le gestionnaire aux messages mentionnant le bot ou y répondant, et ignorez les messages provenant d’autres bots. Sinon, chaque message du groupe déclenche un appel au modèle.
Combien coûte une conversation avec un bot ?
Un court échange de 2 000 tokens d'entrée et 500 tokens de sortie coûte 0,00055 $, soit 0,55 $ pour mille. Les historiques longs coûtent plus cher car ils sont renvoyés à chaque tour.
Le bot peut-il être utilisé pour du jeu de rôle pour adultes ?
Le modèle est ajusté pour répondre sans refus de contenu pour un usage adulte légal, et les bots pour la fiction et le chat de compagnie en sont un cas typique. Le contenu sexuel impliquant des mineurs n'est jamais autorisé, et Telegram a ses propres règles que vous devez respecter.
Votre clé est à un formulaire de vous
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.