DE ▾
nofilterai.top
NoFilter AI
API-Schlüssel erhalten

No-Filter-AI-Discord-Bot: Erstellen in Python

Eine AI-Girlfriend-API bietet eine dedizierte Schnittstelle für Chat-Anwendungen, die romantische oder begleitende Interaktionen mit großen Sprachmodellen simulieren. Dieser Leitfaden vergleicht technische Ansätze, wobei der Fokus auf unzensierten Modellen liegt, die Roleplay-Kontext ohne Standard-Inhaltsablehnungen verarbeiten.

Isometrische Illustration von Chatblasen, die von einem Roboter in Nachrichtenfelder fließen, die einen Discord-Bot darstellen

Was du aufbaust

Ein Bot wie dieser ist ein gewöhnlicher Discord-Bot, dessen Antworten von einem Sprachmodell stammen, das keine legalen Anfragen von Erwachsenen ablehnt. Der Bot hört auf Erwähnungen oder Slash-Befehle, sendet das Gespräch an einen Chat-Completions-Endpunkt und postet die Antwort zurück in den Kanal. An der Discord-Seite ändert sich nichts. Der einzige Unterschied zu einem typischen Tutorial ist, woher der Text stammt.

Diese API ist OpenAI-kompatibel, daher benötigst du keinen speziellen Client. Jedes OpenAI SDK funktioniert, sobald du die Base URL und den Schlüssel änderst. Die Modell-ID ist uncensored. Es ist ein einzelnes Open-Weight-Modell eines unabhängigen Anbieters, das darauf abgestimmt ist, ohne Inhaltsfilter für die legale Nutzung durch Erwachsene zu antworten. Es ist nur Text, also wird der Bot chatten, fiktionale Texte schreiben, Textspiele spielen und Charaktere darstellen, aber er wird keine Bilder oder Audio generieren.

Eine Regel bleibt unverändert, egal wie du den Bot konfigurierst: keine sexuellen Inhalte mit Minderjährigen. Darüber hinaus hat Discord seine eigenen Nutzungsbedingungen und Community-Richtlinien, die für deinen Bot und deinen Server gelten. Plane damit, Bots mit Erwachsenenthemen in altersbeschränkte Kanäle zu stellen und den Nutzern zu sagen, wofür der Bot ist.

Bevor du startest

Du brauchst vier Dinge: ein Discord-Konto, Python 3.10 oder neuer, einen API-Schlüssel und einen Server, auf dem du die Berechtigung hast, einen Bot hinzuzufügen.

  1. Öffne das Discord-Entwicklerportal, erstelle eine Anwendung, füge einen Bot-Benutzer hinzu und kopiere sein Token. Behandle dieses Token wie ein Passwort.
  2. Schalte auf der Bot-Seite die Message Content-Intention ein. Ohne sie erhält dein Bot Nachrichten mit leerem Text.
  3. Lade den Bot mit dem bot-Scope und der Berechtigung zum Lesen und Senden von Nachrichten in deinen Server ein.
  4. Erstelle einen API-Schlüssel auf der API-Schlüssel-Seite. Neue Nutzer können nach der Anmeldung mit einem Klick $0,50 Testguthaben beanspruchen. Es ist 7 Tage gültig und funktioniert für einen ersten Test aller unten genannten Funktionen.

Installiere die beiden Bibliotheken:

pip install discord.py openai
export DISCORD_TOKEN="your-discord-bot-token"
export NOFILTER_API_KEY="your-api-key"

Bewahre beide Werte in Umgebungsvariablen oder einem Secrets-Manager auf. Füge sie niemals in eine Datei ein, die in ein öffentliches Repository geht.

Der minimale Bot

Die erste Version antwortet immer, wenn jemand den Bot erwähnt. Sie verwendet den asynchronen OpenAI-Client, damit der Discord-Event-Loop nicht blockiert, während das Modell schreibt.

import os
import discord
from openai import AsyncOpenAI

ai = AsyncOpenAI(
    base_url="https://api.nofilterai.top/v1",
    api_key=os.environ["NOFILTER_API_KEY"],
)

intents = discord.Intents.default()
intents.message_content = True
bot = discord.Client(intents=intents)

SYSTEM = (
    "You are a witty companion in a Discord server for adults. "
    "Stay in character, keep replies under 1500 characters."
)

@bot.event
async def on_message(message: discord.Message):
    if message.author.bot or bot.user not in message.mentions:
        return
    text = message.clean_content.replace(f"@{bot.user.name}", "").strip()
    async with message.channel.typing():
        resp = await ai.chat.completions.create(
            model="uncensored",
            messages=[
                {"role": "system", "content": SYSTEM},
                {"role": "user", "content": text},
            ],
            temperature=0.9,
            max_tokens=500,
        )
    await message.reply(resp.choices[0].message.content[:1900])

bot.run(os.environ["DISCORD_TOKEN"])

Zwei Details sind hier wichtig. Discord lehnt Nachrichten ab, die länger als 2.000 Zeichen sind, daher fordert der Code im System-Prompt eine kurze Antwort an und schneidet den Text bei 1.900 Zeichen als Sicherheitsnetz ab. Und max_tokens ist auf dieser API optional, aber die Einstellung verhindert, dass eine unkontrollierte Antwort mehr kostet als geplant.

Speicher pro Kanal hinzufügen

Ein Bot ohne Speicher wirkt nach zwei Nachrichten kaputt. Die Lösung ist, eine kurze Liste der letzten Durchgänge für jeden Kanal zu behalten und sie mit jeder Anfrage zu senden. Die API ist zustandslos, daher ist die Historie komplett deine Verantwortung.

from collections import defaultdict, deque

MAX_TURNS = 16
history = defaultdict(lambda: deque(maxlen=MAX_TURNS))

async def reply_with_memory(message, text):
    h = history[message.channel.id]
    h.append({"role": "user", "content": f"{message.author.display_name}: {text}"})
    resp = await ai.chat.completions.create(
        model="uncensored",
        messages=[{"role": "system", "content": SYSTEM}, *h],
        temperature=0.9,
        max_tokens=500,
    )
    answer = resp.choices[0].message.content
    h.append({"role": "assistant", "content": answer})
    return answer

Das Voranstellen des Anzeigenamens jeder Benutzerzeile ermöglicht es dem Modell, Sprecher in einem geschäftigen Kanal zu unterscheiden. Ein deque mit maxlen wirft die ältesten Durchgänge automatisch weg. Sechzehn Durchgänge sind ein guter Start. Das Kontextfenster hat 100.000 Token, also könntest du weit mehr behalten, aber jeder zusätzliche Durchgang wird als Input auf jeder späteren Anfrage abgerechnet. Längerer Speicher ist eine Produktentscheidung, kein technisches Limit.

Länger laufende Charaktere

Wenn ein Charakter Fakten über Wochen hinweg speichern muss, speichere eine kurze Zusammenfassung pro Kanal in einer Datei oder Datenbank und füge sie dem System-Prompt hinzu. Bitte das Modell selbst, die Zusammenfassung etwa alle 30 Durchgänge zu aktualisieren. So bleibt der Prompt klein, während der Charakter sich Namen, laufende Witze und Handlungspunkte merkt.

Innerhalb der Ratenlimits bleiben

Ein Voll-Key erlaubt 8 parallele Anfragen und 300 Anfragen pro Minute. Ein Trial-Key erlaubt 2 parallele Anfragen und 60 pro Minute. Ein einzelner ruhiger Server wird diese Zahlen nie erreichen, aber ein beliebter Kanal kann mehrere Erwähnungen in derselben Sekunde auslösen.

Die einfachste Schutzmaßnahme ist ein Semaphore, das parallele Aufrufe unter dem Parallelitätslimit hält, plus ein Retry für gelegentliche 429. Die API signalisiert Probleme mit HTTP 429 und einem Fehlercode: rate_limited bedeutet zu viele Anfragen pro Minute, concurrency bedeutet zu viele gleichzeitig. Bei temporärer Überlastung sendet sie auch Retry-After: 5.

import asyncio
from openai import RateLimitError

gate = asyncio.Semaphore(6)

async def ask(messages):
    async with gate:
        for attempt in range(4):
            try:
                r = await ai.chat.completions.create(
                    model="uncensored", messages=messages, max_tokens=500
                )
                return r.choices[0].message.content
            except RateLimitError:
                await asyncio.sleep(5 * (attempt + 1))
    return "I am busy right now, try again in a moment."

Wenn du Antworten streamst und die Discord-Nachricht bearbeitest, während Tokens ankommen, denke daran, dass eine gestreamte Anfrage ihren Parallelitätsplatz bis zum Streamende hält. Streaming fühlt sich schneller an, aber Discord begrenzt, wie oft du eine Nachricht bearbeiten kannst, also aktualisiere den Text etwa jede Sekunde statt bei jedem Token. Für die meisten Bots ist eine normale nicht-gestreamte Antwort plus der Tipp-Indikator einfacher und funktioniert gut.

Slash-Befehle, Personas und Serverregeln

Erwähnungen sind der schnellste Weg zu starten, aber Slash-Befehle geben Nutzern eine sauberere Oberfläche. Mit discord.app_commands kannst du /persona hinzufügen, um den System-Prompt zu wechseln, /reset um die Kanal-Historie zu löschen und /summary um die gespeicherte Zusammenfassung auszudrucken. Jeder Befehl bearbeitet nur das Wörterbuch der oben gezeigten Prompts und Historien.

Einige praktische Gewohnheiten halten einen Server gesund:

  • Betreibe Bots mit Erwachsenenthemen nur in Kanälen, die als altersbeschränkt markiert sind, und gib das im Kanal-Thema an.
  • Setze das Charakter-Briefing und die Grenzen in den System-Prompt und halte sie kurz. Modelle folgen einem klaren 150-Wörter-Briefing besser als einem langen Regelwerk.
  • Protokolliere Anfrage-IDs. Jede Antwort enthält einen X-Request-Id-Header, der hilft, wenn du eine einzelne seltsame Antwort nachverfolgen musst.
  • Füge eine harte Regel in deinem eigenen Code hinzu, die jede Anfrage ablehnt, die Minderjährige sexualisiert, auch wenn das Modell ebenfalls an diese Regel gebunden ist. Die API wird sie nicht ausliefern, und dein Bot sollte es auch nicht versuchen.

Prompts, die an die API gesendet werden, werden nicht zum Training verwendet, was in deinen Serverregeln erwähnenswert ist, wenn deine Mitglieder über persönliche Dinge chatten. Dein Bot speichert auch alles, was du in die Historie schreibst, also entscheide, wie lange du sie aufbewahrst, und sag es den Leuten.

Was es kostet

Die Preise liegen bei $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token, vom Prepaid-Guthaben ohne Abonnement. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, und Guthaben verfällt nie. Hier ist ein realistischer Chat-Durchgang: 16 Durchgänge Historie plus den System-Prompt ergeben etwa 1.500 Input-Token, und die Antwort ist etwa 300 Token.

TeilTokenPreisKosten
Eingabe1.500$0,15 pro 1M$0,000225
Ausgabe300$0,50 pro 1M$0,000150
Eine Antwort$0,000375

Tausend Antworten kosten 0,375 $. Zehntausend kosten 3,75 $. Eine Aufladung mit 20 $, dem kleinstmöglichen Betrag, deckt etwas mehr als 53.000 Antworten in dieser Größe ab. Aufladungen sind in ganzen Dollar von 20 $ bis 500 $ möglich, mit einem Bonus von 5 % ab 50 $, 10 % ab 100 $ und 15 % ab 200 $. Diese Website akzeptiert nur Krypto: USDT auf TRC20 oder USDC auf Base. Details findest du auf der Preisseite.

Der größte Hebel für die Kosten ist die Verlaufslänge. Wenn du die Anzahl der gespeicherten Turns verdoppelst, verdoppeln sich die Input-Token grob auch. Begrenze sie und beobachte den X-Balance-USD-Antwortheader, der deinen verbleibenden Saldo nach jedem Aufruf meldet. Du kannst ihn protokollieren und den Bot eine Warnung in einem Admin-Kanal posten lassen, wenn er unter einen Schwellenwert fällt.

Fehlerbehebung

Der Bot ist online, antwortet aber nie: Die Message Content-Intention ist fast immer die Ursache. Aktiviere sie im Entwicklerportal und auch im Code, wie oben gezeigt.

Du siehst 429-Fehler unter Last: Reduziere den Semaphore, prüfe, welcher Fehlercode zurückkam, und warte vor dem erneuten Versuch (Backoff). Wenn der Code rate_limited ist, sendest du zu viele Anfragen pro Minute. Wenn es concurrency ist, sind zu viele gleichzeitig in Bearbeitung.

Antworten wirken flach: Erhöhe temperature in Richtung 1.0, füge zwei oder drei Beispielzeilen der Charakterrede zum System-Prompt hinzu und versuche einen kleinen frequency_penalty, um wiederholte Phrasen zu stoppen. Diese Parameter werden an das Modell weitergegeben.

Antworten werden abgeschnitten: Das 2.000-Zeichen-Limit von Discord ist der übliche Grund. Teile lange Antworten in mehrere Nachrichten auf oder bitte um kürzere. Für einen tieferen Blick in die Anfrageoptionen lies den API-Quickstart, und wenn du einen charaktergetriebenen Bot baust, deckt die AI-Companion-API-Seite das Persona-Design detaillierter ab.

Fragen und Antworten

Brauche ich eine spezielle Bibliothek für einen unzensierten Discord-Bot?

Nein. Nutze discord.py (oder discord.js) für Discord und das normale OpenAI SDK für das Modell. Nur die Base URL, der API-Schlüssel und die Modell-ID uncensored ändern sich.

Kann der Bot Bilder oder Sprachantworten generieren?

Nein. Die API ist nur für Text ausgelegt, ohne Bild-, Audio- oder Videogenerierung sowie ohne Embeddings.

Wie viele Nutzer können gleichzeitig mit dem Bot chatten?

Ein Voll-Key erlaubt 8 parallele Anfragen und 300 Anfragen pro Minute. Stelle zusätzliche Anfragen in deinem Bot in eine Warteschlange und versuche es bei HTTP 429 erneut.

Gibt es eine kostenlose Möglichkeit, es zu testen?

Ja. Nach der Anmeldung kannst du mit einem Klick auf der API-Schlüssel-Seite $0,50 Testguthaben beanspruchen. Es ist 7 Tage gültig, einmal pro Person.

Dein Schlüssel ist nur ein Formular entfernt

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

API-Schlüssel erhalten