Uncensored Endpoint Telegram Botu: Python ile Geliştirin
Bir sansürsüz uç nokta Telegram botu oluşturmak için üç parçaya ihtiyacınız vardır: BotFather'dan bir bot tokenı, bir API anahtarı ve her Telegram mesajını sohbet tamamlama yoluna gönderen yaklaşık 80 satır Python. Bu adım adım rehber tam kodu verir, ardından bellek, akış ve limit işleme ekler.
Temel noktalar
- Bot, Telegram için python-telegram-bot ve model için standart OpenAI SDK'sını kullanır.
- Her sohbet için kısa bir geçmiş tutun ve her istek küçük ve ucuz kalsın diye onu kırpın.
- Her token için değil, saniyede bir mesajı düzenleyerek akış yapın.
- Eşzamanlı model çağrılarını bir semafor ile 8'e kadar sınırlandırın ve 429 yanıtlarını yeniden deneyin.

Ne inşa ediyorsunuz
Botun tek işi: Telegram sohbetinden bir metin mesajı almak, bunu o sohbetin geçmişine eklemek, geçmişi uncensored modele göndermek ve cevabı geri göndermektir. Her Telegram sohbetinin kendi belleği vardır, bu yüzden botla konuşan iki kişi birbirlerinin bağlamını asla görmez.
Tamamlanmış proje şu kısımlardan oluşan tek bir dosyadır:
https://api.uncensoredendpoint.com/v1adresine işaret eden OpenAI SDK'sını kullanan bir API istemcisi.- Sonsuza kadar büyümeden, kırpılmış sohbet geçmişi sözlüğü.
- Bir Telegram mesajını düzenleyerek cevabı akış yapan bir mesaj işleyicisi.
- Tam bir anahtarın izin verdiği 8 eşzamanlı istek altında kalmanızı sağlayan bir semafor.
Burada bir veritabanına gerek yok. Bot yeniden başladığında geçmişler sıfırlanır; bu ilk sürüm için uygundur. Daha sonraki bir bölümde kalıcılık eklemek için nereye gideceğiniz ele alınacaktır.
Önkoşullar
Python 3.10 veya daha yeni ve iki kimlik bilgisine ihtiyacınız var.
- Bir Telegram bot tokenı. Telegram içinde BotFather ile bir sohbet açın, yeni bir bot oluşturmak için komutu gönderin, bir ad ve bir kullanıcı adı seçin ve döndürülen tokenı kopyalayın. Tokenı bir şifre gibi muamele edin.
- Bir API anahtarı. Google veya e-posta ve şifre ile anahtar sayfasında kaydolun. Yeni kullanıcılar tek tıkla $0.50 deneme kredisi talep edebilir, bu botu birçok kez test etmek için yeterlidir. Deneme anahtarı 2 eşzamanlı istek ve dakikada 60 istek izni verir.
İki kütüphaneyi yükleyin ve gizli bilgileri ortam değişkenleri olarak dışa aktarın, böylece kaynak kodunuza asla düşmezler:
pip install "python-telegram-bot>=20" openai
export TELEGRAM_TOKEN="123456:your-bot-token"
export API_KEY="your-api-key"
Daha sonra denemeden gerçek trafiğe geçerseniz, kredi $20 ile $500 arasında bir kredi bakiye yükleme işleminin sonucudur; yalnızca kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile. fiyatlandırma sayfası bonus aşamalarını listeler.
Minimal çalışan bir bot
Mesajları yanıtlayan en küçük sürümle başlayın. Henüz akış ve kırpma yok, bu yüzden bağlantıyı doğrulayabilirsiniz.
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()
Çalıştırın, botunuzu Telegram'da açın ve merhaba deyin. answer[:4000] dilimi, Telegram'ın tek bir mesajı 4096 karakterle sınırlandırmasından kaynaklanır. Uzun bir model yanıtı aksi halde gönderme çağrısının başarısız olmasına neden olur. Daha sonra uzun yanıtları kesmek yerine bunları birden fazla mesaja bölebilirsiniz.
OpenAI SDK'sı kısa bir geri çekilme ile bazı hataları, 429 yanıtlarını da dahil olmak üzere kendi başına yeniden dener. max_retries=3 ayarlama, bir yeniden deneme döngüsü yazmadan size biraz başlangıç avantajı verir.
Sonsuza kadar büyümeyen bellek
Sohbet tamamlamalar durum bilgisi taşımaz. Model sadece her istekte size gönderdiklerinizi bilir, bu yüzden bot geçmişi her adımda yeniden gönderir. Bu yüzden sınırsız geçmiş ana maliyet ve gecikme tuzağıdır. Bağlam penceresi 100,000 token'dır, bu çoktur, ancak her adımda her girdi tokenı için ödersiniz ve çoğu sohbet botu buna gerek duymaz.
Basit bir politika iyi çalışır: sistem istemini tutun ve yalnızca son N mesajı tutun. Yirmi mesaj, on kullanıcıdan ve on botdan, günlük sohbetler için uygundur.
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]
Keyfi bir noktada kesmek, bir asistan mesajıyla başlayan bir geçmişe yol açabilir. Bu model için zararsızdır, ancak düzenli bir şey istiyorsanız, kalan ilk mesaj kullanıcıdan değilse bir mesaj daha atın.
Modelin erken dönemlerden gelen gerçekleri hatırlaması gereken karakterler veya uzun hikayeler için kısaltma bu bilgileri kaybeder. İki yaygın çözüm sabitlenmiş bir not ve kayan bir özetdir. Sabitlenmiş bir not, sistem isteminde tutacağınız isimler ve mevcut sahne gibi kısa bir gerçekler bloğudur. Kayan bir özet, modeli yaklaşık her otuz mesajda bir, geçmişin daha eski yarısını bir paragrafa sıkıştırmaya iter; bu parçayı daha sonra bu mesajların yerine depolarsınız.
/reset komutunu ekleyerek history[chat_id] dizisini temizleyin. İnsanlar temiz bir sayfa kullanmayı sever ve bu size hiçbir maliyet getirmez.
Bir mesajı düzenleyerek yanıtı akış yapma
Uzun bir yanıt için on saniye beklemek bir sohbet uygulamasında yavaş hissettirir. Akış, yanıtın ekranda büyümesini sağlar. Telegram bir mesaj token'ı token'ı kabul etmez; bu nedenle hile, bir yer tutucu göndermek ve metin geldikçe onu düzenlemektir. Düzenlemeyi en fazla saniyede bir yapın. Telegram botlara kendi flood limitlerini uygular ve her token'da düzenleme çağrısı yapmak sizi hız sınırına sokar ve akışı yavaşlatır.
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
İki ayrıntı önemlidir. Birincisi, döngüden sonra her zaman son bir düzenleme yapın, çünkü son parçalar genellikle zamanlı düzenlemeler arasında gelir. İkincisi, Telegram metni değiştirmeyen bir düzenlemeyi reddeder, bu yüzden yeni bir şey yoksa çağrıyı atlayın. Kütüphane bu durum için bir hata yükseltir ve düzenleme etrafındaki bir try/except akışı canlı tutar.
Akışlı bir isteğin, akış bitene kadar eşzamanlılık yuvasını tuttuğunu unutmayın. Aynı anda konuşan birçok sohbeti olan bir bot, akış olmadan olduğundan daha erken limite çarpar, bu da bir sonraki bölüme götürür.
Hız limitleri içinde kalma
Tam bir anahtar 8 eşzamanlı istek ve dakikada 300 istek izni verir. Bir deneme anahtarı 2 ve 60 izni verir. Kalabalık bir grup sohbeti kolayca aynı anda 2'yi aşabilir, bu yüzden limitinizi kullandığınız anahtara göre boyutlandırın.
En temiz koruma, model çağrısı etrafındaki bir semafordur. Sınırın ötesindeki istekler API'ye çarpmak yerine işleminizin içinde kuyrukta bekler:
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)
Hâlâ HTTP 429 alırsanız, hata kodunu okuyun. concurrency aynı anda çok fazla çağrı anlamına gelir, rate_limited dakika başına çok fazla anlamına gelir ve Retry-After: 5 ile bir 429 geçici aşırı yük anlamına gelir; beş saniye bekleyin. SDK yeniden deneme bunların çoğunu halleder. Başarısız veya reddedilen istekler ücretlendirilmez, bu yüzden yeniden denemeler faturaya eklemez.
Başka bir koruma mekanizması kullanıcı başına hız kontrolüdür. Tek bir kişi on saniyede on mesaj gönderirse, yanıtların sırayla gelmesi ve bir sohbetin sekiz yuvanın tamamını kullanmaması için sohbet başına bir kilit ile isteklerini sıralayın.
Kişilik, kurallar ve grup sohbetleri
Sistem istemi botun karakterini aldığı yerdir. Onu kısa bir brif gibi yazın: bot kimdir, nasıl konuşur, cevaplar ne kadar uzun olmalı ve ne yapmamalıdır. Yetişkinler için rol yapma veya arkadaş botu için, ortamı ve tonu birkaç satırda tanımlayın ve kullanıcının oradan yönlendirmesine izin verin. Belirli istemler uzunlardan daha iyidir; model kuralların bir sayfasından daha iyi net bir beş satırlık kişiliği takip eder.
Bazı kurallar istemin dışında yer alır. Model, yasal yetişkin kullanımı için içerik reddi olmadan yanıt verir, ancak reşit olmayanlarla ilgili cinsel içerik asla kabul edilmez ve bunu tarafınızda da uygulamanız gerekir. Botunuz herkese açıksa, bunu açıklamasında belirtin, başlangıç mesajına bir yaş bildirimi ekleyin ve Telegram'ın botlar için kendi şartlarına da uymak zorunda olduğunuzu unutmayın. Kullanıcılarınızın konuşmaları API'ye gider ve istemler eğitim için kullanılmaz; kullanıcılarınıza kendi botunuzun neyi depoladığını söyleyin.
Grup sohbetlerinde her mesaja yanıt vermeyin. Bot etiketlendiğinde veya biri botun mesajlarından birine yanıt verdiğinde yanıt verin ve diğer botlar tarafından gönderilen mesajları yok sayın. python-telegram-bot ile update.message.entities üzerinden bir etiket olup olmadığını kontrol edebilir veya update.message.reply_to_message.from_user.id değerini botun kendi kimliğiyle karşılaştırabilirsiniz.
Bir şeyler ters gittiğinde, her çağrı için X-Request-Id yanıt başlığını günlüğe kaydedin; bunu SDK'nın ham yanıt arayüzü üzerinden okuyabilirsiniz. destek sayfası, belirli bir istek hakkında soru sormak için başvuracağınız yerdir.
Gerçek hayatta çalıştırma
Yukarıda kullanılan sorgulama, küçük bir bot için uygundur: işlem Telegram'dan yeni mesajlar için bir döngüde sorgu yapar ve genel bir adrese ihtiyaç duymaz. Bunu otomatik yeniden başlatma ile systemd veya bir kapsayıcı altında çalıştırın ve iki gizli bilgiyi birim dosyasının ortam değişkenlerinde veya bir gizli bilgi deposunda tutun. Bir webhook kurulumu boşta yükü azaltır ancak HTTPS ve genel bir URL gerektirir; bu nedenle sorgulamayla başlayın.
İnsanları davet etmeden önce maliyeti tahmin edin. API, 1M giriş token'ı başına 0,15 $ ve 1M çıkış token'ı başına 0,50 $ ücretlendirir. Kısaltılmış geçmişli tipik bir adımda 2.000 giriş token'ı ve 500 çıkış token'ı için maliyet; giriş için 2.000 x 0,15 $ / 1M = 0,0003 $ ve çıkış için 500 x 0,50 $ / 1M = 0,00025 $ olup toplam 0,00055 $ eder. Bin adım 0,55 $ eder. Bir sohbet her adımda 10.000 giriş token'ına ulaşırsa, giriş kısmı başına 0,0015 $ gelir, bu nedenle kısaltma kendini kısa sürede amorti eder.
Kalıcılığa ihtiyacınız olduğunda, her sohbetin geçmişini SQLite veya Redis'te JSON olarak depolayın, yeniden başlatmadan sonraki ilk mesajda yükleyin ve her yanıtın ardından geri yazın. Bot herkese açıksa kullanıcı başına günlük mesaj sınırı ekleyin; böylece bir hevesli kullanıcı bakiyeyi tüketemez. API dokümantasyonu ayarlayabileceğiniz her parametreyi listeler ve anahtar üretim kontrol listesi anahtarları döndürmeyi ve bakiye başlığını izlemeyi kapsar.
Daha fazla kılavuz
Sorular ve cevaplar
Telegram tarafı için hangi kütüphaneyi kullanmalıyım?
Model tarafı düz bir HTTP API'si olduğu için herhangi bir kütüphane çalışır. Bu rehber, asenkron olan ve asenkron OpenAI istemcisiyle iyi eşleşen python-telegram-bot sürüm 20 veya üzerini kullanır.
Neden botum kendisine veya gruptaki herkese yanıt veriyor?
Gruplarda işleyiciyi botu etiketleyen veya ona yanıt veren mesajlarla sınırlayın ve botlardan gelen mesajları yoksayın. Aksi takdirde gruptaki her mesaj bir model çağrısını tetikler.
Bir bot sohbetinin maliyeti nedir?
2.000 giriş token'ı ve 500 çıkış token'ı içeren kısa bir etkileşim 0,00055 $ tutarındadır, bu nedenle bin tanesi 0,55 $ eder. Uzun geçmişler her adımda yeniden gönderildiği için daha pahalıdır.
Bot yetişkin rol yapma için kullanılabilir mi?
Model, yasal yetişkin kullanım için içerik reddetmeleri olmadan yanıt verecek şekilde ayarlanmıştır; kurgu ve arkadaş sohbeti için botlar tipik bir örnektir. Reşit olmayanlar içeren cinsel içerik asla izin verilmez ve Telegram'ın uymanız gereken kendi kuralları vardır.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.