Atualizado
Bot de Discord de IA sem Filtro: Como Criar em Python
Uma API de namorada de IA fornece uma interface dedicada para aplicativos de chat que simulam interações românticas ou de companheirismo usando grandes modelos de linguagem. Este guia compara abordagens técnicas, focando em modelos sem censura que lidam com o contexto de interpretação de papéis sem recusas padrão de conteúdo.

O que você está construindo
Um bot como este é um bot de Discord comum cujas respostas vêm de um modelo de linguagem que não recusa solicitações legais de adultos. O bot escuta menções ou um comando slash, envia a conversa para um endpoint de chat-completions e publica a resposta de volta no canal. Nada muda no lado do Discord. A única diferença em relação a um tutorial típico é a origem do texto.
Esta API é compatível com OpenAI, então você não precisa de um cliente especial. Qualquer SDK OpenAI funciona assim que você altera a URL base e a chave. O ID do modelo é uncensored. É um único modelo de pesos abertos executado por um provedor independente, ajustado para responder sem recusas de conteúdo para uso adulto legal. É apenas texto, então o bot vai conversar, escrever ficção, executar jogos de texto e interpretar personagens, mas não gerará imagens ou áudio.
Uma regra permanece fixa independentemente de como você configurar o bot: sem conteúdo sexual envolvendo menores de idade. Além disso, o Discord tem seus próprios termos e diretrizes comunitárias, que se aplicam ao seu bot e ao seu servidor. Planeje colocar bots de tema adulto em canais restritos por idade e informar aos usuários para que serve o bot.
Antes de começar
Você precisa de quatro coisas: uma conta no Discord, Python 3.10 ou mais recente, uma chave de API e um servidor onde você tenha permissão para adicionar um bot.
- Abra o portal do desenvolvedor do Discord, crie um aplicativo, adicione um usuário bot e copie seu token. Trate esse token como uma senha.
- Na página do bot, ative a intenção Message Content. Sem isso, seu bot recebe mensagens com texto vazio.
- Convide o bot para o seu servidor com o escopo
bote permissão para ler e enviar mensagens. - Crie uma chave de API na página de chaves de API. Novos usuários podem reivindicar $0,50 de crédito de teste com um clique após o cadastro. É válido por 7 dias e serve para um primeiro teste de tudo abaixo.
Instale as duas bibliotecas:
pip install discord.py openai
export DISCORD_TOKEN="your-discord-bot-token"
export NOFILTER_API_KEY="your-api-key"
Mantenha ambos os valores em variáveis de ambiente ou em um gerenciador de segredos. Nunca cole-os em um arquivo que vá para um repositório público.
O bot mínimo
A primeira versão responde sempre que alguém menciona o bot. Usa o cliente OpenAI assíncrono para que o loop de eventos do Discord nunca bloqueie enquanto o modelo está escrevendo.
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"])
Dois detalhes importam aqui. O Discord rejeita mensagens com mais de 2.000 caracteres, então o código tanto pede uma resposta curta no system prompt quanto fatia o texto em 1.900 como rede de segurança. E max_tokens é opcional nesta API, mas defini-lo evita que uma resposta descontrolada custe mais do que você planejou.
Adicionar memória por canal
Um bot sem memória parece quebrado após duas mensagens. A solução é manter uma lista curta de turnos recentes para cada canal e enviá-la com cada requisição. A API é stateless, então o histórico é inteiramente seu para gerenciar.
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
Prefixar cada linha de usuário com o nome de exibição permite que o modelo diferencie os falantes em um canal movimentado. Um deque com maxlen remove os turnos mais antigos automaticamente. Dezesseis turnos são um bom começo. A janela de contexto tem 100.000 tokens, então você poderia manter muito mais, mas cada turno extra é cobrado como entrada em cada requisição posterior. Memória mais longa é uma decisão de produto, não um limite técnico.
Personagens de execução mais longa
Se um personagem precisa lembrar de fatos ao longo de semanas, armazene um resumo curto por canal em um arquivo ou banco de dados e adicione-o ao system prompt. Peça ao próprio modelo para atualizar o resumo a cada 30 turnos mais ou menos. Isso mantém o prompt pequeno enquanto o personagem ainda lembra nomes, piadas internas e pontos da trama.
Permanecer dentro dos limites de requisições
Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. Uma chave de teste permite 2 requisições simultâneas e 60 por minuto. Um único servidor tranquilo nunca tocará esses números, mas um canal popular pode disparar várias menções no mesmo segundo.
A proteção mais simples é um semáforo que limita chamadas paralelas abaixo do limite de concorrência, mais uma tentativa de novo para o 429 ocasional. A API sinaliza problemas com HTTP 429 e um código de erro: rate_limited significa muitas requisições por minuto, concurrency significa muitas ao mesmo tempo. Em sobrecarga temporária, ela também envia 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."
Se você faz streaming de respostas e edita a mensagem do Discord conforme os tokens chegam, lembre-se de que uma requisição em streaming mantém seu slot de concorrência até o fim do stream. Streaming parece mais rápido, mas o Discord limita com que frequência você pode editar uma mensagem, então atualize o texto a cada segundo mais ou menos em vez de em cada token. Para a maioria dos bots, uma resposta sem streaming mais o indicador de digitação é mais simples e funciona bem.
Comandos slash, personas e regras do servidor
Menções são a maneira mais rápida de começar, mas comandos slash oferecem aos usuários uma interface mais limpa. Com discord.app_commands você pode adicionar /persona para alterar o system prompt, /reset para limpar o histórico do canal e /summary para imprimir o resumo salvo. Cada comando apenas edita o dicionário de prompts e históricos mostrado acima.
Alguns hábitos práticos mantêm um servidor saudável:
- Execute bots de tema adulto apenas em canais marcados como restritos por idade e informe isso no tópico do canal.
- Coloque o resumo do personagem e os limites no prompt do sistema e mantenha-o curto. Os modelos seguem melhor um resumo claro de 150 palavras do que um manual longo.
- Registre IDs de requisição. Cada resposta carrega um cabeçalho
X-Request-Id, o que ajuda quando você precisa rastrear uma única resposta estranha. - Adicione uma regra rígida no seu próprio código que recuse qualquer solicitação que sexualize menores de idade, mesmo que o modelo também esteja vinculado a essa regra. A API não a servirá, e seu bot não deve tentar.
Prompts enviados para a API não são usados para treinamento, o que vale a pena mencionar nas regras do seu servidor se seus membros conversarem sobre coisas pessoais. Seu bot também armazena tudo o que você coloca no histórico, então decida por quanto tempo mantê-lo e informe às pessoas.
Quanto custa para executar
O preço é $0,15 por 1M tokens de entrada e $0,50 por 1M tokens de saída, a partir de crédito pré-pago sem assinatura. Requisições falhas ou recusadas não são cobradas, e o crédito nunca expira. Aqui está um turno de chat realista: 16 turnos de histórico mais o system prompt totalizam cerca de 1.500 tokens de entrada, e a resposta tem cerca de 300 tokens.
| Parte | Tokens | Taxa | Custo |
|---|---|---|---|
| Entrada | 1,500 | $0,15 por 1M | $0.000225 |
| Saída | 300 | $0,50 por 1M | $0.000150 |
| Uma resposta | $0.000375 |
Mil respostas custam $0,375. Dez mil custam $3,75. Uma recarga de $20, o valor mínimo, cobre pouco mais de 53.000 respostas nesse tamanho. As recargas variam de $20 a $500 em dólares inteiros, com bônus de 5% a partir de $50, 10% a partir de $100 e 15% a partir de $200. Este site aceita apenas cripto: USDT na rede TRC20 ou USDC na rede Base. Veja a página de preços para os detalhes.
A maior alavanca de custo é o comprimento do histórico. Se você duplicar os turnos mantidos, os tokens de entrada aproximadamente dobrarão também. Limite-os e monitore o cabeçalho de resposta X-Balance-USD, que relata seu saldo restante após cada chamada. Você pode registrá-lo e fazer o bot postar um aviso em um canal de admin quando cair abaixo de um limite.
Solução de Problemas
O bot está online, mas nunca responde: a intenção Message Content é quase sempre a causa. Ative-a no portal do desenvolvedor e também no código, conforme mostrado acima.
Você vê erros 429 sob carga: reduza o semáforo, verifique qual código de erro voltou e recue. Se o código for rate_limited, você está enviando muitas requisições por minuto. Se for concurrency, muitas estão em execução ao mesmo tempo.
As respostas parecem sem graça: aumente temperature em direção a 1,0, adicione duas ou três linhas de exemplo do discurso do personagem ao prompt do sistema e tente um pequeno frequency_penalty para evitar frases repetidas. Esses parâmetros são repassados ao modelo.
As respostas são cortadas: o limite de 2.000 caracteres do Discord é o motivo usual. Divida respostas longas em várias mensagens ou peça respostas mais curtas. Para uma análise mais profunda das opções de requisição, leia o quickstart da API e, se você está construindo um bot baseado em personagem, a página da API de companheira de IA cobre o design de persona com mais detalhes.
Mais guias
Perguntas e respostas
Preciso de uma biblioteca especial para um bot de Discord sem filtros?
Não. Use discord.py (ou discord.js) para Discord e o SDK OpenAI padrão para o modelo. Apenas a URL base, a chave e o ID do modelo uncensored mudam.
O bot pode gerar imagens ou respostas de voz?
Não. A API é apenas de texto, sem geração de imagem, áudio ou vídeo e sem embeddings.
Quantos usuários podem conversar com o bot ao mesmo tempo?
Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. Coloque em fila as requisições extras no seu bot e tente novamente ao receber HTTP 429.
Existe uma maneira gratuita de testar?
Sim. Após se cadastrar, você pode reivindicar $0,50 de crédito de teste com um clique na página da chave de API. É válido por 7 dias, um por pessoa.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.
Obter chave de API