Bot Telegram Uncensored Endpoint: Buat dengan Python
Untuk membuat bot telegram endpoint tanpa sensor, Anda memerlukan tiga bagian: token bot dari BotFather, kunci API, dan sekitar 80 baris Python yang meneruskan setiap pesan Telegram ke rute penyelesaian chat. Penjelasan ini memberikan kode lengkap, lalu menambahkan memori, streaming, dan penanganan batas.
Poin utama
- Bot menggunakan python-telegram-bot untuk Telegram dan SDK OpenAI standar untuk model.
- Simpan riwayat singkat per obrolan dan pangkas agar setiap permintaan tetap kecil dan murah.
- Streaming dengan mengedit satu pesan sekitar sekali per detik, bukan pada setiap token.
- Batasi panggilan model paralel hingga 8 dengan semafor dan coba ulang respons 429.

Yang sedang Anda bangun
Bot memiliki satu tugas: mengambil pesan teks dari obrolan Telegram, menambahkannya ke riwayat obrolan tersebut, mengirim riwayat ke model uncensored, dan mengirimkan kembali jawabannya. Setiap obrolan Telegram memiliki memori sendiri, sehingga dua orang yang berbicara dengan bot tidak pernah melihat konteks satu sama lain.
Proyek yang selesai adalah satu file dengan bagian-bagian berikut:
- Klien untuk API, menggunakan SDK OpenAI yang diarahkan ke
https://api.uncensoredendpoint.com/v1. - Kamus riwayat obrolan, yang dipangkas agar tidak tumbuh tanpa batas.
- Penangan pesan yang mengalirkan jawaban dengan mengedit satu pesan Telegram.
- Semafor yang menjaga Anda tetap di bawah 8 permintaan konkurensi yang diizinkan kunci penuh.
Tidak ada di sini yang memerlukan basis data. Saat bot dimulai ulang, riwayat direset, yang baik untuk versi pertama. Bagian selanjutnya membahas cara menambahkan persistensi.
Prasyarat
Anda memerlukan Python 3.10 atau lebih baru dan dua kredensial.
- Token bot Telegram. Buka obrolan dengan BotFather di dalam Telegram, kirim perintah untuk membuat bot baru, pilih nama dan nama pengguna, dan salin token yang dikembalikan. Perlakukan token seperti kata sandi.
- Kunci API. Daftar di halaman kunci dengan Google atau dengan email dan kata sandi. Pengguna baru dapat mengklaim $0,50 kredit uji coba dengan satu klik, yang cukup untuk menguji bot ini berkali-kali. Kunci uji coba memungkinkan 2 permintaan paralel dan 60 permintaan per menit.
Instal kedua pustaka dan ekspor rahasia sebagai variabel lingkungan agar tidak pernah masuk ke kode sumber Anda:
pip install "python-telegram-bot>=20" openai
export TELEGRAM_TOKEN="123456:your-bot-token"
export API_KEY="your-api-key"
Jika Anda beralih dari uji coba ke lalu lintas nyata, saldo berasal dari isi saldo dengan kripto (USDT di TRC20, USDC di Base) sebesar $20 hingga $500. Halaman harga mencantumkan tingkat bonus.
Bot kerja minimal
Mulailah dengan versi terkecil yang menjawab pesan. Versi ini belum memiliki streaming dan belum ada pemangkasan, sehingga Anda dapat memverifikasi infrastruktur terlebih dahulu.
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()
Jalankan, buka bot Anda di Telegram, dan ucapkan halo. Irisan answer[:4000] ada karena Telegram membatasi satu pesan hingga 4096 karakter. Jawaban model yang panjang akan membuat panggilan kirim gagal. Nanti Anda dapat membagi jawaban panjang menjadi beberapa pesan alih-alih memotongnya.
SDK OpenAI mencoba kembali beberapa kegagalan secara mandiri, termasuk respons 429, dengan jeda singkat. Mengatur max_retries=3 memberi Anda sedikit ruang gerak tanpa menulis loop percobaan ulang terlebih dahulu.
Memori yang tidak tumbuh selamanya
Penyelesaian obrolan bersifat stateless. Model hanya mengetahui apa yang Anda kirim dalam setiap permintaan, sehingga bot mengirim ulang riwayat setiap giliran. Itulah mengapa riwayat tak terbatas adalah jebakan biaya dan latensi utama. Jendela konteks adalah 100.000 token, yang banyak, tetapi Anda membayar setiap token input pada setiap giliran, dan sebagian besar bot obrolan tidak membutuhkan sebanyak itu.
Kebijakan sederhana bekerja dengan baik: pertahankan prompt sistem, dan simpan hanya N pesan terakhir. Dua puluh pesan, sepuluh dari pengguna dan sepuluh dari bot, cocok untuk obrolan santai.
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]
Memotong pada titik sewenang-wenang dapat meninggalkan riwayat yang dimulai dengan pesan asisten. Itu tidak berbahaya untuk model ini, tetapi jika Anda ingin rapi, buang satu pesan lagi ketika pesan pertama yang tersisa bukan dari pengguna.
Untuk karakter atau cerita panjang di mana model harus mengingat fakta dari awal, pemangkasan akan kehilangannya. Dua perbaikan umum adalah catatan pin dan ringkasan bergulir. Catatan pin adalah blok fakta singkat yang Anda simpan dalam prompt sistem, seperti nama dan adegan saat ini. Ringkasan bergulir meminta model, setiap tiga puluh pesan atau lebih, untuk memampatkan separuh riwayat yang lebih lama menjadi paragraf, yang kemudian Anda simpan di tempat pesan-pesan tersebut.
Tambahkan perintah /reset yang menghapus history[chat_id]. Orang suka memiliki awal yang bersih, dan itu tidak membebani Anda.
Mengalirkan balasan dengan mengedit satu pesan
Menunggu sepuluh detik untuk jawaban panjang terasa lambat di aplikasi chat. Streaming memungkinkan balasan tumbuh di layar. Telegram tidak menerima token pesan satu per satu, sehingga triknya adalah mengirim penanda tempat, lalu mengeditnya saat teks tiba. Edit sekitar sekali per detik paling banyak. Telegram menerapkan batas banjirnya sendiri untuk bot, dan memukul panggilan edit pada setiap token akan membuat Anda dibatasi dan memperlambat 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
Dua hal penting. Pertama, selalu lakukan edit terakhir setelah loop, karena potongan terakhir biasanya tiba di antara edit berkala. Kedua, Telegram menolak edit yang tidak mengubah teks, sehingga lewati panggilan ketika tidak ada yang baru. Pustaka menimbulkan galat untuk kasus itu, dan coba/tangkap di sekitar edit menjaga streaming tetap hidup.
Ingat bahwa permintaan yang dialirkan memegang slot konkurensinya hingga aliran berakhir. Bot dengan banyak obrolan yang berbicara sekaligus akan mencapai batas lebih cepat dengan streaming daripada tanpa, yang mengarah ke bagian berikutnya.
Tetap dalam batas laju
Kunci penuh mengizinkan 8 permintaan konkurensi dan 300 permintaan per menit. Kunci uji coba mengizinkan 2 dan 60. Grup obrolan yang sibuk dapat dengan mudah melebihi 2 sekaligus, sehingga sesuaikan batas Anda dengan kunci yang Anda gunakan.
Pelindung terbersih adalah semafor di sekitar panggilan model. Permintaan di luar batas menunggu di baris di dalam proses Anda alih-alih memantul dari 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)
Jika Anda masih mendapatkan HTTP 429, baca kode galat. concurrency berarti terlalu banyak panggilan sekaligus, rate_limited berarti terlalu banyak per menit, dan 429 dengan Retry-After: 5 berarti kelebihan beban sementara; tunggu lima detik. Percobaan ulang SDK menangani sebagian besar ini. Permintaan yang gagal atau ditolak tidak dibebankan biaya, sehingga percobaan ulang tidak menambah tagihan.
Pelindung lain adalah pengendalian kecepatan per pengguna. Jika satu orang mengirim sepuluh pesan dalam sepuluh detik, serialkan permintaan mereka dengan kunci per obrolan agar jawaban tiba secara berurutan dan satu obrolan tidak menggunakan semua delapan slot.
Persona, aturan, dan obrolan grup
Prompt sistem adalah tempat bot mendapatkan karakternya. Tulis seperti ringkasan singkat: bot apa, bagaimana cara bicaranya, seberapa panjang jawaban harusnya, dan apa saja yang tidak boleh dilakukan. Untuk bot roleplay atau teman untuk dewasa, jelaskan pengaturan dan nada dalam beberapa baris dan biarkan pengguna mengarahkannya dari sana. Prompt spesifik mengalahkan yang panjang; model mengikuti persona lima baris yang jelas lebih baik daripada halaman aturan.
Beberapa aturan berada di luar prompt. Model menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, tetapi konten seksual yang melibatkan anak di bawah umur tidak pernah diizinkan, dan Anda harus menegakkannya di sisi Anda juga. Jika bot Anda terbuka untuk publik, sebutkan dalam deskripsinya, tambahkan peringatan usia dalam pesan awal, dan ingat bahwa Telegram memiliki syarat sendiri untuk bot yang juga harus Anda ikuti. Percakapan pengguna Anda dikirim ke API, dan prompt tidak digunakan untuk pelatihan; beri tahu pengguna Anda apa yang disimpan bot Anda sendiri.
Dalam obrolan grup, jangan menjawab setiap pesan. Balas hanya ketika bot disebutkan atau ketika seseorang membalas salah satu pesan bot, dan abaikan pesan yang dikirim oleh bot lain. Di python-telegram-bot, Anda dapat memeriksa update.message.entities untuk menyebutkan atau membandingkan update.message.reply_to_message.from_user.id dengan ID bot sendiri.
Saat terjadi kesalahan, catat header respons X-Request-Id untuk setiap panggilan; Anda dapat membacanya melalui antarmuka respons mentah SDK. Halaman bantuan adalah tempat untuk menanyakan permintaan tertentu.
Menjalankannya secara nyata
Polling, seperti yang digunakan di atas, baik untuk bot kecil: proses meminta Telegram untuk pesan baru dalam loop dan tidak memerlukan alamat publik. Jalankan di bawah systemd atau wadah dengan restart otomatis, dan simpan dua rahasia di lingkungan file unit atau toko rahasia. Penyiapan webhook mengurangi beban idle, tetapi memerlukan HTTPS dan URL publik, sehingga mulailah dengan polling.
Perkirakan biaya sebelum mengundang orang. API membebankan $0,15 per 1 juta token input dan $0,50 per 1 juta token output. Giliran khas dengan riwayat yang dipangkas sebesar 2.000 token input dan 500 token output berharga 2.000 x $0,15 / 1 juta = $0,0003 untuk input ditambah 500 x $0,50 / 1 juta = $0,00025 untuk output, yang merupakan $0,00055. Seribu giliran berharga $0,55. Jika obrolan tumbuh menjadi 10.000 token input per giliran, bagian input saja menjadi $0,0015, sehingga pemangkasan membayar dirinya sendiri dengan cepat.
Ketika Anda memerlukan persistensi, simpan riwayat setiap percakapan sebagai JSON di SQLite atau Redis, muat pada pesan pertama setelah restart, dan tulis kembali setelah setiap balasan. Tambahkan batas pesan harian per pengguna jika bot bersifat publik, agar satu pengguna bersemangat tidak menguras saldo. Dokumentasi API mencantumkan setiap parameter yang dapat Anda atur, dan checklist produksi kunci mencakup rotasi kunci dan memantau header saldo.
Panduan lainnya
Tanya jawab
Pustaka mana yang harus saya gunakan untuk sisi Telegram?
Pustaka apa pun berfungsi karena sisi model adalah API HTTP biasa. Panduan ini menggunakan python-telegram-bot versi 20 atau yang lebih baru, yang bersifat asinkron dan cocok dengan klien OpenAI asinkron.
Mengapa bot saya membalas dirinya sendiri atau kepada semua orang di grup?
Dalam grup, batasi handler agar hanya menangani pesan yang menyebutkan bot atau membalasnya, dan abaikan pesan dari bot. Jika tidak, setiap pesan dalam grup akan memicu panggilan model.
Berapa biaya percakapan bot?
Pertukaran singkat dengan 2.000 token input dan 500 token output berharga $0,00055, sehingga seribu pertukaran berharga $0,55. Riwayat yang lebih panjang lebih mahal karena dikirim ulang setiap giliran.
Dapatkah bot digunakan untuk bermain peran dewasa?
Model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, dan bot untuk obrolan fiksi serta teman adalah kasus yang umum. Konten seksual yang melibatkan anak di bawah umur tidak pernah diizinkan, dan Telegram memiliki aturan sendiri yang harus Anda ikuti.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.