DE ▾
API-Schlüssel erhalten

Uncensored Endpoint-Telegram-Bot: Erstelle ihn in Python

Um einen unzensierten Telegram-Bot zu erstellen, benötigst du drei Dinge: ein Bot-Token von BotFather, einen API-Schlüssel und etwa 80 Zeilen Python-Code, die jede Telegram-Nachricht an den Chat-Vervollständigungs-Endpunkt senden. Diese Anleitung liefert den vollständigen Code und fügt dann Speicher, Streaming und Limit-Handling hinzu.

Aktualisiert

Wichtige Punkte

  1. Der Bot verwendet python-telegram-bot für Telegram und das Standard-OpenAI-SDK für das Modell.
  2. Halte einen kurzen Verlauf pro Chat und kürze ihn, damit jede Anfrage klein und günstig bleibt.
  3. Streame, indem du etwa einmal pro Sekunde eine Nachricht bearbeitest, nicht bei jedem Token.
  4. Begrenze parallele Modellaufrufe auf 8 mit einem Semaphor und wiederhole 429-Antworten.
Papierflieger-Chatblase, die von einem Terminal zu einer Reihe von Sprechblasen geht, die einen Telegram-Bot darstellen

Was du aufbaust

Der Bot hat eine Aufgabe: Eine Textnachricht aus einem Telegram-Chat aufnehmen, sie zum Verlauf dieses Chats hinzufügen, den Verlauf an das Modell uncensored senden und die Antwort zurückposten. Jeder Telegram-Chat erhält seinen eigenen Speicher, sodass zwei Personen, die mit dem Bot sprechen, niemals den Kontext des anderen sehen.

Das fertige Projekt ist eine einzige Datei mit diesen Teilen:

  1. Ein Client für die API, der das OpenAI-SDK verwendet und auf https://api.uncensoredendpoint.com/v1 zeigt.
  2. Ein Wörterbuch der Chat-Verläufe, das so gekürzt wird, dass es nie unbegrenzt wächst.
  3. Ein Nachrichten-Handler, der die Antwort streamt, indem er eine einzelne Telegram-Nachricht bearbeitet.
  4. Ein Semaphore, das dich unter den 8 gleichzeitigen Anfragen hält, die ein voller Schlüssel erlaubt.

Hierfür wird keine Datenbank benötigt. Wenn der Bot neu startet, werden die Verläufe zurückgesetzt, was für eine erste Version in Ordnung ist. Ein späterer Abschnitt behandelt, wo du Persistenz hinzufügen kannst.

Voraussetzungen

Du benötigst Python 3.10 oder neuer und zwei Anmeldeinformationen.

  • Ein Telegram-Bot-Token. Öffne einen Chat mit BotFather in Telegram, sende den Befehl, um einen neuen Bot zu erstellen, wähle einen Namen und einen Benutzernamen und kopiere das zurückgegebene Token. Behandle das Token wie ein Passwort.
  • Ein API-Schlüssel. Melde dich auf der Schlüsselseite mit Google oder mit E-Mail und Passwort an. Neue Nutzer können mit einem Klick $0,50 an Prepaid-Guthaben beanspruchen, was ausreicht, um diesen Bot häufig zu testen. Der Trial-Schlüssel erlaubt 2 parallele Anfragen und 60 Anfragen pro Minute.

Installiere die beiden Bibliotheken und exportiere die Geheimnisse als Umgebungsvariablen, damit sie niemals in deinem Quellcode landen:

pip install "python-telegram-bot>=20" openai
export TELEGRAM_TOKEN="123456:your-bot-token"
export API_KEY="your-api-key"

Wenn du später vom Trial- zum echten Verkehr wechselst, stammt das Guthaben von einer Zahlung per Krypto-Aufladung von $20 bis $500, entweder USDT auf TRC20 oder USDC auf Base. Die Preisseite listet die Bonusstufen auf.

Ein minimal funktionierender Bot

Beginne mit der kleinsten Version, die Nachrichten beantwortet. Sie hat noch kein Streaming und kein Trimmen, damit du die Verbindung zuerst bestätigen kannst.

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()

Führe es aus, öffne deinen Bot in Telegram und sage Hallo. Der Slice answer[:4000] existiert, weil Telegram eine einzelne Nachricht auf 4096 Zeichen begrenzt. Eine lange Modellantwort würde sonst dazu führen, dass der Send-Aufruf fehlschlägt. Später kannst du lange Antworten stattdessen in mehrere Nachrichten aufteilen.

Das OpenAI-SDK wiederholt einige Fehler selbst, einschließlich 429-Antworten, mit einer kurzen Verzögerung. Das Setzen von max_retries=3 gibt dir etwas Spielraum, ohne dass du noch eine Wiederholungsschleife schreiben musst.

Speicher, der nicht unbegrenzt wächst

Chat-Vervollständigungen sind zustandslos. Das Modell kennt nur das, was du in jeder Anfrage sendest, daher sendet der Bot den Verlauf bei jedem Schritt erneut. Deshalb ist ein unbeschränkter Verlauf die Hauptfalle für Kosten und Latenz. Das Kontextfenster umfasst 100.000 Token, was viel ist, aber du zahlst für jedes Input-Token bei jedem Schritt, und die meisten Chat-Bots benötigen bei weitem nicht so viel.

Eine einfache Richtlinie funktioniert gut: Behalte den System-Prompt und behalte nur die letzten N Nachrichten. Zwanzig Nachrichten, zehn vom Benutzer und zehn vom Bot, eignen sich für einen lockeren Chat.

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]

Das Abschneiden an einer beliebigen Stelle kann einen Verlauf hinterlassen, der mit einer Assistenten-Nachricht beginnt. Das ist für dieses Modell harmlos, aber wenn du es ordentlich haben möchtest, entferne eine weitere Nachricht, wenn die erste verbleibende Nachricht nicht vom Benutzer stammt.

Für Charaktere oder lange Geschichten, bei denen das Modell sich Fakten aus dem frühen Verlauf merken muss, führt das Trimmen zum Verlust. Zwei häufige Lösungen sind eine angeheftete Notiz und eine laufende Zusammenfassung. Eine angeheftete Notiz ist ein kurzer Block von Fakten, den du im System-Prompt behältst, wie Namen und die aktuelle Szene. Eine laufende Zusammenfassung bittet das Modell, etwa alle dreißig Nachrichten die ältere Hälfte des Verlaufs in einen Absatz zu komprimieren, den du dann anstelle dieser Nachrichten speicherst.

Füge einen /reset-Befehl hinzu, der history[chat_id] löscht. Nutzer schätzen einen sauberen Start, und das kostet dich nichts.

Die Antwort durch Bearbeiten einer Nachricht streamen

Zehn Sekunden auf eine lange Antwort zu warten, fühlt sich in einer Chat-App langsam an. Streaming lässt die Antwort auf dem Bildschirm wachsen. Telegram akzeptiert keine Nachricht Token für Token, daher ist der Trick, einen Platzhalter zu senden und ihn dann zu bearbeiten, wenn Text eingeht. Bearbeite höchstens einmal pro Sekunde. Telegram wendet seine eigenen Rate-Limits für Bots an, und das Hämmern des Edit-Vorgangs bei jedem Token führt zu Drosselung und verlangsamt den Stream.

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

Zwei Details sind wichtig. Erstens führe immer eine letzte Bearbeitung nach der Schleife durch, da die letzten Fragmente normalerweise zwischen den zeitgesteuerten Bearbeitungen ankommen. Zweitens lehnt Telegram eine Bearbeitung ab, die den Text nicht ändert, also überspringe den Aufruf, wenn nichts Neues vorhanden ist. Die Bibliothek löst in diesem Fall einen Fehler aus, und ein try/except um die Bearbeitung hält den Stream aufrecht.

Denke daran, dass eine gestreamte Anfrage ihren Parallelitäts-Slot hält, bis der Stream endet. Ein Bot mit vielen Chats, die gleichzeitig sprechen, erreicht das Limit mit Streaming früher als ohne, was zum nächsten Abschnitt führt.

Innerhalb der Ratenlimits bleiben

Ein voller Schlüssel erlaubt 8 parallele Anfragen und 300 Anfragen pro Minute. Ein Test-Schlüssel erlaubt 2 und 60. Ein überlasteter Gruppenchat kann leicht 2 gleichzeitig überschreiten, also passe deine Grenze an den verwendeten Schlüssel an.

Der sauberste Schutz ist ein Semaphore um den Modellaufruf. Anfragen jenseits der Kapazität warten in deiner Prozesswarteschlange, anstatt gegen die API zu prallen:

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)

Wenn du trotzdem HTTP 429 erhältst, lies den Fehlercode. concurrency bedeutet zu viele Aufrufe gleichzeitig, rate_limited bedeutet zu viele pro Minute, und ein 429 mit Retry-After: 5 bedeutet temporäre Überlastung; warte fünf Sekunden. Der SDK-Retry behandelt die meisten Fälle. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, also erhöhen Retries die Rechnung nicht.

Ein weiterer Schutz ist die pro-Benutzer-Taktung. Wenn eine einzelne Person zehn Nachrichten in zehn Sekunden sendet, serialisiere ihre Anfragen mit einer Sperre pro Chat, damit die Antworten in der richtigen Reihenfolge eintreffen und ein Chat nicht alle acht Slots belegt.

Persona, Regeln und Gruppenchats

Der System-Prompt ist der Ort, an dem der Bot seinen Charakter erhält. Schreibe ihn wie einen kurzen Entwurf: Wer der Bot ist, wie er spricht, wie lang die Antworten sein sollten und was er nicht tun darf. Für einen Roleplay- oder Companion-Bot für Erwachsene beschreibe die Umgebung und den Tonfall in wenigen Zeilen und überlasse dem Benutzer die Steuerung ab dort. Spezifische Prompts schlagen lange; das Modell folgt einer klaren fünfzeiligen Persona besser als einer Seite voller Regeln.

Einige Regeln befinden sich außerhalb des Prompts. Das Modell antwortet ohne Inhaltsfilter für die rechtmäßige Erwachsenennutzung, aber sexuelle Inhalte, die Minderjährige betreffen, sind niemals erlaubt, und du solltest das auch auf deiner Seite durchsetzen. Wenn dein Bot für die Öffentlichkeit zugänglich ist, sag das in seiner Beschreibung, füge einen Altershinweis in der Startnachricht hinzu und denke daran, dass Telegram eigene Nutzungsbedingungen für Bots hat, die du ebenfalls befolgen musst. Die Unterhaltungen deiner Nutzer gehen an die API, und Prompts werden nicht zum Training verwendet; teile deinen Nutzern mit, was dein eigener Bot speichert.

Beantworte in Gruppenchats nicht jede Nachricht. Antworte nur, wenn der Bot erwähnt wird oder jemand auf eine seiner Nachrichten antwortet, und ignoriere Nachrichten, die von anderen Bots gesendet wurden. In python-telegram-bot kannst du auf update.message.entities auf eine Erwähnung prüfen oder update.message.reply_to_message.from_user.id mit der eigenen ID des Bots vergleichen.

Wenn etwas schiefgeht, protokolliere den X-Request-Id-Antwortheader für jeden Aufruf; du kannst ihn über die Raw-Response-Schnittstelle des SDK lesen. Die Support-Seite ist der Ort, um nach einer bestimmten Anfrage zu fragen.

Der echte Einsatz

Polling, wie oben verwendet, ist für einen kleinen Bot in Ordnung: Der Prozess fragt in einer Schleife bei Telegram nach neuen Nachrichten und benötigt keine öffentliche Adresse. Führe es unter systemd oder einem Container mit automatischem Neustart aus und halte die beiden Geheimnisse in der Umgebungsvariable der Unit-Datei oder einem Secrets-Store. Ein Webhook-Setup senkt die Leerlaufbelastung, benötigt jedoch HTTPS und eine öffentliche URL, also beginne mit Polling.

Schätze die Kosten ab, bevor du Leute einlädst. Die API berechnet 0,15 $ pro 1M Input-Token und 0,50 $ pro 1M Output-Token. Ein typischer Schritt mit einem gekürzten Verlauf von 2.000 Input-Token und 500 Output-Token kostet 2.000 x 0,15 $ / 1M = 0,0003 $ für Input plus 500 x 0,50 $ / 1M = 0,00025 $ für Output, was 0,00055 $ ergibt. Tausend Schritte kosten 0,55 $. Wenn ein Chat auf 10.000 Input-Token pro Schritt wächst, wird der Input-Teil allein zu 0,0015 $, daher zahlt sich das Kürzen schnell aus.

Wenn du Persistenz benötigst, speichere die Historie jedes Chats als JSON in SQLite oder Redis, lade sie bei der ersten Nachricht nach einem Neustart und schreibe sie nach jeder Antwort zurück. Füge ein tägliches Nachrichtenlimit pro Benutzer hinzu, wenn der Bot öffentlich ist, damit ein begeisterter Benutzer das Guthaben nicht leeren kann. Die API-Dokumentation listet alle Parameter auf, die du anpassen kannst, und die Checkliste für den Produktivbetrieb behandelt das Drehen von Schlüsseln und das Beobachten des Guthaben-Headers.

Fragen und Antworten

Welche Bibliothek soll ich für Telegram verwenden?

Jede Bibliothek funktioniert, da die Modellseite eine einfache HTTP-API ist. Dieser Leitfaden verwendet python-telegram-bot Version 20 oder neuer, das asynchron ist und gut mit dem asynchronen OpenAI-Client funktioniert.

Warum antwortet mein Bot auf sich selbst oder auf alle in einer Gruppe?

Beschränke den Handler in Gruppen auf Nachrichten, die den Bot erwähnen oder darauf antworten, und ignoriere Nachrichten von Bots. Andernfalls löst jede Nachricht in der Gruppe einen Modellaufruf aus.

Wie viel kostet eine Bot-Konversation?

Ein kurzer Austausch von 2.000 Input-Token und 500 Output-Token kostet 0,00055 $, also kosten tausend davon 0,55 $. Längere Verläufe kosten mehr, weil sie bei jedem Schritt erneut gesendet werden.

Kann der Bot für Adult-Rollenspiele verwendet werden?

Das Modell ist darauf abgestimmt, ohne Inhaltsfilter bei rechtmäßiger Erwachsennutzung zu antworten, und Bots für Fiktion und Companion-Chat sind ein typischer Fall. Sexuelle Inhalte, die Minderjährige betreffen, sind niemals erlaubt, und Telegram hat eigene Regeln, die du befolgen musst.

Dein Schlüssel ist nur ein Formular entfernt

Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.

API-Schlüssel erhaltenLies die Dokumentation