FR ▾
nofilterai.top
NoFilter AI
Obtenir une clé API

Bot Discord IA sans filtre : créer en Python

Une API IA petite amie fournit une interface dédiée aux applications de chat qui simulent des interactions romantiques ou de compagnie à l’aide de grands modèles de langage. Ce guide compare les approches techniques, en se concentrant sur les modèles sans censure qui gèrent le contexte de jeu de rôle sans les refus de contenu standards.

Illustration isométrique de bulles de discussion provenant d'un robot vers des panneaux de messages, représentant un bot Discord

Ce que vous construisez

Un bot comme celui-ci est un bot Discord ordinaire dont les réponses proviennent d'un modèle de langage qui ne refuse pas les demandes légales d'adultes. Le bot écoute les mentions ou une commande slash, envoie la conversation à un endpoint chat-completions, et publie la réponse dans le canal. Rien ne change côté Discord. La seule différence par rapport à un tutoriel classique réside dans l'origine du texte.

Cette API est compatible OpenAI, donc vous n'avez pas besoin d'un client spécial. Tout SDK OpenAI fonctionne une fois que vous avez modifié l'URL de base et la clé. L'ID du modèle est uncensored. Il s'agit d'un modèle à poids ouverts unique, géré par un fournisseur indépendant, optimisé pour répondre sans refus de contenu pour une utilisation adulte légale. Il est textuel uniquement, donc le bot discutera, écrira de la fiction, jouera à des jeux de texte et incarnera des personnages, mais il ne générera pas d'images ni d'audio.

Une règle reste fixe quelle que soit la configuration du bot : aucun contenu sexuel impliquant des mineurs. Au-delà de cela, Discord a ses propres conditions d'utilisation et directives communautaires, qui s'appliquent à votre bot et à votre serveur. Prévoyez de placer les bots à thème adulte dans des canaux restreints aux adultes et d'informer les utilisateurs de l'objectif du bot.

Avant de commencer

Vous avez besoin de quatre éléments : un compte Discord, Python 3.10 ou plus récent, une clé API et un serveur où vous avez la permission d'ajouter un bot.

  1. Ouvrez le portail développeur Discord, créez une application, ajoutez un utilisateur bot et copiez son jeton. Traitez ce jeton comme un mot de passe.
  2. Sur la page du bot, activez l'intention Message Content. Sans cela, votre bot reçoit des messages avec un texte vide.
  3. Invitez le bot sur votre serveur avec la portée bot et la permission de lire et envoyer des messages.
  4. Créez une clé API sur la page Clé API. Les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d'essai en un clic après s'être inscrits. Il est valable 7 jours et permet de tester tout ce qui suit.

Installez les deux bibliothèques :

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

Conservez ces deux valeurs dans des variables d'environnement ou un gestionnaire de secrets. Ne les collez jamais dans un fichier envoyé à un dépôt public.

Le bot minimal

La première version répond chaque fois que quelqu'un mentionne le bot. Elle utilise le client OpenAI asynchrone pour que la boucle d'événements Discord ne se bloque jamais pendant que le modèle écrit.

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"])

Deux détails sont importants ici. Discord rejette les messages de plus de 2 000 caractères, donc le code demande une réponse courte dans le prompt système et tronque le texte à 1 900 caractères comme filet de sécurité. Et max_tokens est optionnel sur cette API, mais le définir empêche une réponse débridée de coûter plus que prévu.

Ajouter de la mémoire par canal

Un bot sans mémoire semble cassé après deux messages. La solution est de conserver une courte liste des derniers échanges pour chaque canal et de les envoyer avec chaque requête. L'API est sans état, donc l'historique est entièrement à votre charge de gérer.

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

Préfixer chaque ligne utilisateur avec le nom d'affichage permet au modèle de distinguer les interlocuteurs dans un canal animé. Un deque avec maxlen supprime automatiquement les anciens échanges. Seize échanges sont un bon point de départ. La fenêtre de contexte est de 100 000 tokens, vous pourriez donc en conserver bien plus, mais chaque échange supplémentaire est facturé en entrée à chaque requête ultérieure. Une mémoire plus longue est une décision produit, pas une limite technique.

Personnages à longue durée de vie

Si un personnage doit se souvenir de faits sur plusieurs semaines, stockez un court résumé par canal dans un fichier ou une base de données et ajoutez-le au prompt système. Demandez au modèle de rafraîchir le résumé tous les 30 échanges environ. Cela garde le prompt petit tout en conservant la mémoire des noms, blagues récurrentes et points d'intrigue.

Respecter les limites de débit

Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute. Une clé d'essai permet 2 requêtes simultanées et 60 par minute. Un serveur calme unique ne touchera jamais ces chiffres, mais un canal populaire peut déclencher plusieurs mentions en une seconde.

La protection la plus simple est un sémaphore qui limite les appels parallèles en dessous de la limite de concurrence, plus une nouvelle tentative pour les 429 occasionnels. L'API signale les problèmes avec l'erreur HTTP 429 et un code d'erreur : rate_limited signifie trop de requêtes par minute, concurrency signifie trop de requêtes simultanées. En cas de surcharge temporaire, elle envoie également 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."

Si vous diffusez les réponses et modifiez le message Discord au fur et à mesure de l'arrivée des tokens, sachez qu'une requête en streaming occupe sa place de concurrence jusqu'à la fin du flux. Le streaming semble plus rapide, mais Discord limite la fréquence de modification d'un message, donc mettez à jour le texte toutes les secondes environ plutôt qu'à chaque token. Pour la plupart des bots, une réponse classique non diffusée plus l'indicateur de frappe est plus simple et fonctionne bien.

Commandes slash, personas et règles du serveur

Les mentions sont le moyen le plus rapide de démarrer, mais les commandes slash offrent une interface plus propre. Avec discord.app_commands vous pouvez ajouter /persona pour changer le prompt système, /reset pour effacer l'historique du canal et /summary pour afficher le résumé enregistré. Chaque commande ne modifie que le dictionnaire des prompts et historiques montré ci-dessus.

Quelques habitudes pratiques maintiennent un serveur en bonne santé :

  • Exécutez les bots à thème adulte uniquement dans les canaux marqués comme restreints aux adultes, et indiquez-le dans le sujet du canal.
  • Placez le profil du personnage et les limites dans le prompt système, et gardez-le court. Les modèles suivent mieux un profil clair de 150 mots qu'un manuel de règles long.
  • Journalisez les IDs de requête. Chaque réponse comporte un en-tête X-Request-Id, ce qui aide lorsque vous devez tracer une réponse étrange unique.
  • Ajoutez une règle stricte dans votre propre code qui refuse toute requête sexualisant des mineurs, même si le modèle est également lié par cette règle. L'API ne la servira pas, et votre bot ne devrait pas essayer.

Les prompts envoyés à l'API ne sont pas utilisés pour l'apprentissage, ce qui vaut la peine d'être mentionné dans les règles de votre serveur si vos membres discutent de choses personnelles. Votre bot stocke également tout ce que vous mettez dans l'historique, donc décidez combien de temps le conserver et informez les utilisateurs.

Coût d'utilisation

La tarification est de 0,15 $ par 1M de tokens d'entrée et de 0,50 $ par 1M de tokens de sortie, prélevés sur le crédit prépayé sans abonnement. Les requêtes échouées ou refusées ne sont pas facturées, et le crédit n'expire jamais. Voici un tour de chat réaliste : 16 échanges d'historique plus le prompt système représentent environ 1 500 tokens d'entrée, et la réponse fait environ 300 tokens.

PartieTokensTauxCoût
Entrée1 5000,15 $ par 1M$0,000225
Sortie3000,50 $ par 1M$0,000150
Une réponse$0,000375

Mille réponses coûtent 0,375 $. Dix mille coûtent 3,75 $. Un rechargement de 20 $, le montant minimum, couvre un peu plus de 53 000 réponses de cette taille. Les rechargements vont de 20 $ à 500 $ en dollars entiers, avec un bonus de 5 % à partir de 50 $, 10 % à partir de 100 $ et 15 % à partir de 200 $. Ce site accepte uniquement la crypto : USDT sur TRC20 ou USDC sur Base. Consultez la page de tarification pour les détails.

Le plus grand levier sur les coûts est la longueur de l'historique. Si vous doublez les échanges conservés, les tokens d'entrée doublent également. Limitez-les et surveillez l'en-tête de réponse X-Balance-USD, qui indique votre solde restant après chaque appel. Vous pouvez le journaliser et faire publier une alerte par le bot dans un canal admin lorsqu'il tombe en dessous d'un seuil.

Dépannage

Le bot est en ligne mais ne répond jamais : l'intention Message Content en est presque toujours la cause. Activez-la dans le portail développeur et également dans le code, comme montré ci-dessus.

Vous voyez des erreurs 429 sous charge : réduisez le sémaphore, vérifiez quel code d'erreur est renvoyé, et ralentissez. Si le code est rate_limited, vous envoyez trop de requêtes par minute. Si c'est concurrency, trop sont en cours simultanément.

Les réponses semblent plates : augmentez temperature vers 1.0, ajoutez deux ou trois lignes d'exemple du discours du personnage au prompt système, et essayez un petit frequency_penalty pour arrêter les phrases répétées. Ces paramètres sont transmis au modèle.

Les réponses sont coupées : la limite de 2 000 caractères de Discord en est généralement la raison. Divisez les longues réponses en plusieurs messages, ou demandez des réponses plus courtes. Pour un aperçu plus approfondi des options de requête, consultez le démarrage rapide de l'API, et si vous créez un bot axé sur un personnage, la page API compagnon IA couvre la conception du persona plus en détail.

Questions et réponses

Dois-je utiliser une bibliothèque spéciale pour un bot Discord sans filtre ?

Non. Utilisez discord.py (ou discord.js) pour Discord et le SDK OpenAI classique pour le modèle. Seule l'URL de base, la clé et l'ID du modèle uncensored changent.

Le bot peut-il générer des images ou des réponses vocales ?

Non. L'API est uniquement textuelle, sans génération d'images, d'audio ou de vidéo, et sans embeddings.

Combien d'utilisateurs peuvent discuter avec le bot en même temps ?

Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute. Mettez en file d'attente les requêtes supplémentaires dans votre bot et réessayez en cas d'erreur HTTP 429.

Existe-t-il un moyen gratuit de le tester ?

Oui. Après votre inscription, vous pouvez réclamer 0,50 $ de crédit d'essai gratuit en un clic sur la page de la clé API. Il est valable 7 jours, un seul par personne.

Votre clé n'est qu'à un formulaire d'ici

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.

Obtenir une clé API