Uncensored Endpoint टेलीग्राम बॉट: इसे पायथन में बनाएं
एक अनसेंसर्ड एंडपॉइंट टेलीग्राम बॉट बनाने के लिए आपको तीन चीज़ों की ज़रूरत है: BotFather से एक बॉट टोकन, एक API कुंजी, और लगभग 80 लाइन पायथन जो हर टेलीग्राम संदेश को चैट कंप्लीशन रूट पर भेजता है। यह वॉकथ्रू पूरा कोड देता है, फिर मेमोरी, स्ट्रीमिंग और लिमिट हैंडलिंग जोड़ता है।
मुख्य बिंदु
- बॉट टेलीग्राम के लिए python-telegram-bot और मॉडल के लिए स्टैंडर्ड ओपनएआई एसडीके उपयोग करता है।
- प्रत्येक चैट के लिए एक छोटा इतिहास रखें और उसे ट्रिम करें ताकि प्रत्येक अनुरोध छोटा और सस्ता रहे।
- स्ट्रीमिंग करें हर सेकंड में एक बार एक संदेश को एडिट करके, हर टोकन पर नहीं।
- समानांतर मॉडल कॉल्स को एक सेमाफोर के साथ 8 पर सीमित करें और 429 प्रतिक्रियाओं को पुनः प्रयास करें।

आप क्या बना रहे हैं
बॉट का एक ही काम है: Telegram चैट से टेक्स्ट संदेश लेना, उसे उस चैट के इतिहास में जोड़ना, इतिहास को मॉडल uncensored को भेजना, और जवाब वापस पोस्ट करना। प्रत्येक Telegram चैट का अपना मेमोरी होता है, इसलिए बॉट से बात करने वाले दो लोगों को एक-दूसरे का कॉन्टेक्स्ट कभी नहीं दिखता।
पूर्ण प्रोजेक्ट एक ही फ़ाइल है जिसमें ये हिस्से हैं:
- API के लिए एक क्लाइंट, जो
https://api.uncensoredendpoint.com/v1पर इंगित OpenAI SDK का उपयोग करता है। - चैट इतिहास का एक शब्दकोश, जिसे इस तरह ट्राइम किया गया है कि यह कभी भी असीमित रूप से न बढ़े।
- एक मैसेज हैंडलर जो एक Telegram संदेश को एडिट करके जवाब को स्ट्रीम करता है।
- एक सेमाफोर जो आपको एक पूर्ण कुंजी द्वारा अनुमत 8 समानांतर अनुरोधों से नीचे रखता है।
यहाँ किसी डेटाबेस की आवश्यकता नहीं है। जब बॉट रीस्टार्ट होता है, तो इतिहास रीसेट हो जाते हैं, जो पहली वर्जन के लिए ठीक है। बाद के सेक्शन में पर्सिस्टेंस जोड़ने के बारे में बताया गया है।
आवश्यकताएं
आपको Python 3.10 या उससे नया और दो क्रेडेंशियल्स की आवश्यकता है।
- एक Telegram बॉट टोकन। Telegram के अंदर BotFather से चैट शुरू करें, नया बॉट बनाने के लिए कमांड भेजें, एक नाम और यूज़रनेम चुनें, और उस टोकन को कॉपी करें जो वह लौटाता है। टोकन को पासवर्ड की तरह मानें।
- एक 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"
यदि आप बाद में ट्रायल से असली ट्रैफ़िक पर जाते हैं, तो क्रेडिट क्रिप्टो टॉप-अप से आता है, जिसकी राशि $20 से $500 तक होती है, या तो TRC20 पर USDT या Base पर USDC के रूप में। प्राइसिंग पेज पर बोनस टियर सूचीबद्ध हैं।
एक न्यूनतम कार्यशील बॉट
सबसे छोटे वर्जन से शुरू करें जो संदेशों का जवाब देता है। इसमें अभी न तो स्ट्रीमिंग है और न ही ट्राइमिंग, ताकि आप प्लंबिंग की पुष्टि कर सकें।
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 वर्णों तक सीमित करता है। एक लंबे मॉडल उत्तर के वरना भेजने का कॉल विफल हो जाएगा। बाद में आप लंबे उत्तरों को काटने के बजाय कई संदेशों में विभाजित कर सकते हैं।
OpenAI SDK कुछ विफलताओं को अपने आप रीट्राई करता है, जिसमें 429 रिस्पॉन्स शामिल हैं, एक छोटे बैकऑफ़ के साथ। max_retries=3 सेट करने से आपको बिना रीट्राई लूप लिखे थोड़ी हेडरूम मिलती है।
मेमोरी जो अनंत तक नहीं बढ़ती
चैट पूर्णतया अवस्था-रहित (stateless) हैं। मॉडल केवल प्रत्येक अनुरोध में भेजे गए डेटा को जानता है, इसलिए बॉट हर बारी पर इतिहास फिर से भेजता है। यही कारण है कि असीमित इतिहास मुख्य लागत और विलंबता का जाल है। कॉन्टेक्स्ट विंडो 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
दो बातें मायने रखती हैं। पहली, लूप के बाद अंतिम संपादन (final edit) हमेशा करें, क्योंकि आखिरी चंक आमतौर पर टाइम्ड संपादन के बीच आते हैं। दूसरी, टेलीग्राम उस संपादन को अस्वीकार कर देता है जिसमें टेक्स्ट में कोई बदलाव नहीं होता, इसलिए जब कुछ नया न हो तो कॉल छोड़ दें। लाइब्रेरी उस मामले में एक त्रुटि (error) फेंकती है, और संपादन के चारों ओर try/except रखने से स्ट्रीम जीवित रहती है।
याद रखें कि एक स्ट्रीम किए गए अनुरोध (streamed request) अपनी कॉन्करेंसी स्लॉट को स्ट्रीम समाप्त होने तक पकड़े रखता है। एक बॉट जिसमें कई चैट एक साथ बात कर रही हों, स्ट्रीमिंग के बिना की तुलना में स्ट्रीमिंग के साथ सीमा (limit) जल्दी पार कर लेगा, जिससे अगले खंड की ओर संकेत मिलता है।
रेट लिमिट के भीतर रहना
एक पूर्ण कुंजी 8 समानांतर अनुरोधों और प्रति मिनट 300 अनुरोधों की अनुमति देती है। एक ट्रायल कुंजी 2 समानांतर अनुरोधों और प्रति मिनट 60 अनुरोधों की अनुमति देती है। एक व्यस्त ग्रुप चैट आसानी से एक साथ 2 से अधिक समानांतर अनुरोधों को पार कर सकती है, इसलिए अपनी सीमा को उस कुंजी के अनुसार सेट करें जिसका आप उपयोग कर रहे हैं।
सबसे साफ़ गार्ड मॉडल कॉल के चारों ओर एक सेमाफोर (semaphore) है। कैप से अधिक अनुरोध 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 का अर्थ प्रति मिनट बहुत सारे हैं, और Retry-After: 5 के साथ एक 429 का अर्थ अस्थायी ओवरलोड है; पांच सेकंड प्रतीक्षा करें। SDK रीट्राइस इनमें से अधिकांश को संभाल लेता है। विफल या अस्वीकृत अनुरोधों के लिए चार्ज नहीं किया जाता है, इसलिए रीट्राइस बिल में जोड़ते नहीं हैं।
एक और गार्ड प्रति-उपयोगकर्ता गति नियंत्रण है। यदि एक व्यक्ति दस सेकंड में दस संदेश भेजता है, तो उनके अनुरोधों को प्रति-चैट लॉक के साथ क्रमबद्ध करें ताकि उत्तर क्रम में आएं और एक चैट आठों स्लॉट्स का उपयोग न करे।
पर्सोना, नियम और ग्रुप चैट
सिस्टम प्रॉम्प्ट वह जगह है जहाँ बॉट को उसका किरदार मिलता है। इसे एक छोटे ब्रीफ की तरह लिखें: बॉट कौन है, यह कैसे बोलता है, उत्तर कितने लंबे होने चाहिए, और उसे क्या नहीं करना चाहिए। वयस्कों के लिए रोलप्ले या कंपैनियन बॉट के लिए, सेटिंग और टोन को कुछ पंक्तियों में वर्णित करें और उपयोगकर्ता को वहाँ से आगे निर्देशित करने दें। विशिष्ट प्रॉम्प्ट लंबे प्रॉम्प्ट से बेहतर हैं; मॉडल नियमों के पृष्ठ की तुलना में एक स्पष्ट पाँच-पंक्ति वाले पर्सोना का बेहतर पालन करता है।
कुछ नियम प्रॉम्प्ट के बाहर होते हैं। मॉडल कानूनी वयस्क उपयोग के लिए बिना सेंसर के उत्तर देता है, लेकिन नाबालिगों से संबंधित यौन सामग्री की कभी अनुमति नहीं होती, और आपको इसे अपनी ओर से भी लागू करना चाहिए। यदि आपका बॉट सार्वजनिक है, तो इसे अपने विवरण में बताएं, शुरुआती संदेश में आयु सूचना जोड़ें, और याद रखें कि टेलीग्राम के बॉट्स के लिए अपने नियम हैं जिन्हें आपको भी मानना होगा। आपके उपयोगकर्ताओं की बातचीत API पर जाती है, और प्रॉम्प्ट को ट्रेनिंग के लिए उपयोग नहीं किया जाता है; अपने उपयोगकर्ताओं को बताएं कि आपका बॉट क्या स्टोर करता है।
ग्रुप चैट्स में, हर संदेश का उत्तर न दें। केवल तब प्रतिक्रिया दें जब बॉट को उल्लेख किया गया हो या किसी ने उसके संदेश का जवाब दिया हो, और अन्य बॉट्स द्वारा भेजे गए संदेशों को अनदेखा करें। python-telegram-bot में आप update.message.entities के लिए एक उल्लेख की जांच कर सकते हैं या update.message.reply_to_message.from_user.id को बॉट के अपने ID से तुलना कर सकते हैं।
जब कुछ गलत होता है, तो हर कॉल के लिए X-Request-Id रिस्पॉन्स हेडर लॉग करें; आप इसे SDK के रॉ रिस्पॉन्स इंटरफ़ेस से पढ़ सकते हैं। किसी विशेष अनुरोध के बारे में पूछने के लिए सपोर्ट पेज सही जगह है।
इसे वास्तव में चलाना
पोलिंग, जैसा कि ऊपर उपयोग किया गया है, एक छोटे बॉट के लिए ठीक है: प्रक्रिया टेलीग्राम से लूप में नए संदेश मांगती है और इसके लिए कोई सार्वजनिक पता की आवश्यकता नहीं है। इसे systemd या एक कंटेनर के तहत चलाएं जिसमें स्वचालित पुनरारंभ हो, और दो रहस्यों को यूनिट फाइल के एन्वायरनमेंट या सीक्रेट्स स्टोर में रखें। वेबहुक सेटअप आइडल लोड कम करता है, लेकिन इसके लिए HTTPS और एक सार्वजनिक URL की आवश्यकता होती है, इसलिए पोलिंग से शुरू करें।
लोगों को आमंत्रित करने से पहले लागत का अनुमान लगाएं। API प्रति 1M इनपुट टोकन के लिए $0.15 और प्रति 1M आउटपुट टोकन के लिए $0.50 चार्ज करता है। एक सामान्य टर्न जिसमें 2,000 इनपुट टोकन और 500 आउटपुट टोकन का ट्रिम किया गया इतिहास होता है, उसकी लागत इनपुट के लिए 2,000 x $0.15 / 1M = $0.0003 और आउटपुट के लिए 500 x $0.50 / 1M = $0.00025 होती है, जो कुल $0.00055 है। एक हज़ार टर्न की लागत $0.55 है। यदि एक चैट प्रति टर्न 10,000 इनपुट टोकन तक बढ़ जाती है, तो केवल इनपुट हिस्सा $0.0015 हो जाता है, इसलिए ट्रिमिंग जल्दी ही अपनी लागत कमा लेती है।
जब आपको स्थायित्व (persistence) चाहिए, तो हर चैट का इतिहास SQLite या Redis में JSON के रूप में सहेजें, रीस्टार्ट के बाद पहले संदेश पर उसे लोड करें और हर जवाब के बाद वापस लिख दें। यदि बॉट सार्वजनिक है तो प्रति उपयोगकर्ता दैनिक संदेश सीमा जोड़ें, ताकि एक उत्साही उपयोगकर्ता बैलेंस खत्म न कर दे। API दस्तावेज़ में हर वह पैरामीटर सूचीबद्ध है जिसे आप ट्यून कर सकते हैं, और कुंजी प्रोडक्शन चेकलिस्ट में कुंजियाँ रोटेट करने और बैलेंस हेडर पर नज़र रखने की जानकारी है।
अधिक गाइड
प्रश्न और उत्तर
Telegram साइड के लिए मुझे कौन सी लाइब्रेरी उपयोग करनी चाहिए?
किसी भी लाइब्रेरी का उपयोग किया जा सकता है क्योंकि मॉडल साइड एक साधारण HTTP API है। यह गाइड python-telegram-bot संस्करण 20 या नवीनतम का उपयोग करती है, जो असिंक्रोनस है और async OpenAI क्लाइंट के साथ अच्छी तरह से काम करती है।
मेरा बॉट स्वयं या समूह में हर किसी को उत्तर क्यों देता है?
ग्रुप्स में, हैंडलर को उन संदेशों तक सीमित करें जो बॉट को उल्लेख करते हैं या उसका जवाब देते हैं, और बॉट्स से संदेशों को अनदेखा करें। अन्यथा, ग्रुप में हर संदेश एक मॉडल कॉल ट्रिगर करता है।
एक बॉट कन्वर्सेशन की लागत कितनी है?
2,000 इनपुट टोकन और 500 आउटपुट टोकन की एक छोटी अदला-बदली की लागत $0.00055 है, इसलिए एक हज़ार की लागत $0.55 है। लंबे इतिहास अधिक महंगे पड़ते हैं क्योंकि उन्हें हर टर्न पर फिर से भेजा जाता है।
क्या बॉट को वयस्क रोलप्ले के लिए उपयोग किया जा सकता है?
मॉडल कानूनी वयस्कों के उपयोग के लिए सामग्री अस्वीकृतियों के बिना उत्तर देने के लिए ट्यून्ड है, और कथा और साथी चैट के लिए बॉट्स एक सामान्य मामला हैं। नाबालिगों से जुड़ा यौन सामग्री कभी भी अनुमत नहीं है, और टेलीग्राम के अपने नियम हैं जिन्हें आपको पालना है।
आपकी कुंजी बस एक फ़ॉर्म दूर है
एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।