güncellendi
Filtresiz AI Discord Botu: Python ile Oluşturun
Bir AI sevgili API'si, büyük dil modellerini kullanarak romantik veya eş benzeri etkileşimleri simüle eden sohbet uygulamaları için özel bir arayüz sağlar. Bu kılavuz, standart içerik reddi yerine rol yapma bağlamını işleyen sansürsüz modellere odaklanarak teknik yaklaşımları karşılaştırır.

Ne inşa ediyorsunuz
Bu tür bir bot, yasal yetişkin istekleri reddetmeyen bir dil modelinden yanıtlar alan sıradan bir Discord botudur. Bot, bahsetmeleri veya bir slash komutunu dinler, konuşmayı bir chat-completions uç noktasına gönderir ve cevabı kanala yazar. Discord tarafında hiçbir şey değişmez. Tipik bir öğreticiden tek fark, metnin nereden geldiğidir.
Bu API OpenAI ile uyumludur, bu nedenle özel bir istemciye ihtiyacınız yoktur. Base URL'yi ve anahtarı değiştirdiğinizde herhangi bir OpenAI SDK çalışır. Model ID'si uncensored'dir. Bağımsız bir sağlayıcı tarafından yönetilen, yasal yetişkin kullanımı için içerik reddetmeleri olmadan cevap verecek şekilde ayarlanmış tek bir açık ağırlıklı modeldir. Yalnızca metin destekler, bu nedenle bot sohbet eder, kurgu yazar, metin oyunları oynar ve karakterleri canlandırır, ancak görsel veya ses üretmez.
Botu nasıl yapılandırırsanız yapılandırın, değişmeyen bir kural vardır: reşit olmayanları içeren cinsel içerik yok. Bunun ötesinde, Discord'un kendi şartları ve topluluk yönergeleri vardır ve bunlar botunuza ve sunucunuza uygulanır. Yetişkin temalı botları yaş kısıtlamalı kanallarda tutmayı ve kullanıcılara botun ne için olduğunu söylemeyi planlayın.
Başlamadan önce
Dört şeye ihtiyacınız var: bir Discord hesabı, Python 3.10 veya daha yeni, bir API anahtarı ve bir bot eklemeye izniniz olan bir sunucu.
- Discord geliştirici portalını açın, bir uygulama oluşturun, bir bot kullanıcısı ekleyin ve belirtecini kopyalayın. Bu belirteci bir şifre gibi kullanın.
- Bot sayfasında Mesaj İçeriği niyetini etkinleştirin. Aksi takdirde botunuz boş metinli mesajlar alır.
- Botu
botkapsamıyla ve mesajları okuma ve gönderme izniyle sunucunuza davet edin. - API anahtarı sayfasında bir API anahtarı oluşturun. Yeni kullanıcılar, kayıt olduktan sonra tek tıkla $0,50 deneme kredisi talep edebilir. 7 gün geçerlidir ve aşağıdaki her şeyin ilk testi için yeterlidir.
İki kütüphaneyi yükleyin:
pip install discord.py openai
export DISCORD_TOKEN="your-discord-bot-token"
export NOFILTER_API_KEY="your-api-key"
Her iki değeri de ortam değişkenlerinde veya bir gizli yöneticide tutun. Onları halka açık bir depoya giden bir dosyaya yapıştırmayın.
Minimal bot
İlk sürüm, biri bottan bahsettiğinde yanıt verir. Model yazarken Discord olay döngüsünün asla engellenmemesi için asenkron OpenAI istemcisini kullanır.
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"])
Burada iki ayrıntı önemlidir. Discord 2.000 karakterden uzun mesajları reddeder, bu nedenle kod hem sistem isteminde kısa bir yanıt ister hem de metni 1.900'de keser. Ve max_tokens bu API'de isteğe bağlıdır, ancak ayarlamak kontrolden çıkmış bir yanıtın planladığınızdan pahalıya mal olmasını önler.
Kanal başına hafıza ekle
Hafızası olmayan bir bot, iki mesajdan sonra bozuk hissettirir. Çözüm, her kanal için yakın geçmişin kısa bir listesini tutmak ve her istekle göndermektir. API durumsizdir, bu nedenle geçmişi tamamen yönetmek size aittir.
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
Her kullanıcı satırını gösterim adıyla öneklemek, modelin kalabalık bir kanalda konuşmacıları ayırt etmesini sağlar. maxlen ile bir deque, en eski dönüşleri kendi başına düşürür. On altı dönüş mantıklı bir başlangıçtır. Bağlam penceresi 100.000 token'dır, bu nedenle çok daha fazlasını tutabilirsiniz, ancak her ek dönüş, sonraki her istekte girdi olarak faturalandırılır. Daha uzun hafıza teknik bir sınır değil, bir ürün kararıdır.
Daha uzun süre çalışan karakterler
Bir karakterin haftalarca gerçekleri hatırlaması gerekiyorsa, bir dosyada veya veritabanında kanal başına kısa bir özet depolayın ve sistem istemine ekleyin. Modelden her 30 dönüşte bir özetin yenilenmesini isteyin. Bu, istemi küçük tutarken karakter hala isimleri, devam eden şakaları ve hikaye noktalarını hatırlar.
Hız limitlerinin içinde kalın
Tam anahtar 8 eşzamanlı istek ve dakika başına 300 istek sağlar. Bir deneme anahtarı 2 eşzamanlı istek ve dakika başına 60 sağlar. Sessiz bir sunucu bu sayılara asla ulaşmaz, ancak popüler bir kanal aynı saniyede birkaç bahsetme tetikleyebilir.
En basit koruma, eşzamanlılık sınırının altında paralel çağrıları sınırlayan bir semafor ve ara sıra 429 için bir yeniden denemedir. API, sorunları HTTP 429 ve bir hata koduyla bildirir: rate_limited dakika başına çok fazla istek anlamına gelir, concurrency aynı anda çok fazla istek anlamına gelir. Geçici aşırı yüklenme durumunda ayrıca Retry-After: 5 gönderir.
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."
Yanıtları akış olarak gönderirseniz ve tokenlar geldikçe Discord mesajını düzenlerseniz, akışlı bir isteğin akış bitene kadar eşzamanlılık yuvasını tuttuğunu unutmayın. Akış daha hızlı görünür, ancak Discord bir mesajı ne sıklıkta düzenleyebileceğinizi sınırlar, bu nedenle metni her token'da değil, yaklaşık olarak her saniyede güncelleyin. Çoğu bot için düz bir akışsız yanıt ve yazma göstergesi daha basittir ve iyi çalışır.
Slash komutları, karakterler ve sunucu kuralları
Bahsetmeler başlatmanın en hızlı yoludur, ancak slash komutları kullanıcılara daha temiz bir arayüz sağlar. discord.app_commands ile sistem istemini değiştirmek için /persona, kanal geçmişini temizlemek için /reset ve kaydedilen özeti yazdırmak için /summary ekleyebilirsiniz. Her komut yalnızca yukarıda gösterilen istekler ve geçmişler sözlüğünü düzenler.
Sunucuyu sağlıklı tutmak için birkaç pratik alışkanlık:
- Yetişkin temalı botları yalnızca yaş kısıtlamalı olarak işaretlenmiş kanallarda çalıştırın ve bunu kanal konusuna yazın.
- Karakter taslağını ve sınırları sistem istemine koyun ve kısa tutun. Modeller uzun bir kurallar kitabından daha iyi 150 kelimelik net bir taslağı takip eder.
- İstek kimliklerini günlüğe kaydedin. Her yanıt, tek bir tuhaf yanıtı izlemeniz gerektiğinde yardımcı olan bir
X-Request-Idüst bilgisini taşır. - Kendinize ait kodunuza reşit olmayanları cinselleştiren herhangi bir isteği reddeden katı bir kural ekleyin, model de bu kurala bağlı olsa bile. API bunu sunmaz ve botunuz denememelidir.
API'ye gönderilen istemler eğitim için kullanılmaz, bu üyeleriniz kişisel şeyler hakkında sohbet ediyorsa sunucu kurallarınızda söylemeye değer. Botunuz ayrıca geçmişe koyduğunuz her şeyi depolar, bu nedenle ne kadar süreyle tutacağınıza karar verin ve insanlara söyleyin.
Çalıştırmanın Maliyeti
Fiyatlandırma, ön ödemeli krediden 1M girdi token başına 0,15 $ ve 1M çıktı token başına 0,50 $'dır, abonelik yoktur. Başarısız veya reddedilen istekler için ücret alınmaz ve kredi hiç sona ermez. Gerçekçi bir sohbet dönüşü şöyledir: 16 dönüşluk geçmiş ve sistem istemi yaklaşık 1.500 girdi token'a gelir ve yanıt yaklaşık 300 token'dır.
| Parça | Tokenlar | Oran | Maliyet |
|---|---|---|---|
| Girdi | 1.500 | $0,15 per 1M | $0,000225 |
| Çıktı | 300 | $0,50 per 1M | $0,000150 |
| Tek bir yanıt | $0,000375 |
Bin yanıt 0,375 $ maliyetinde. On bin yanıt 3,75 $ maliyetinde. En küçük tutar olan 20 $ bakiye yükleme, bu boyutta 53.000'den fazla yanıtı karşılar. Bakiye yüklemeler 20 $ ile 500 $ arasında tam dolar miktarlarda çalışır, 50 $'dan itibaren %5 bonus, 100 $'dan itibaren %10 ve 200 $'dan itibaren %15 bonus sağlanır. Bu site yalnızca kripto kabul eder: TRC20 üzerinde USDT veya Base üzerinde USDC. Detaylar için fiyatlandırma sayfasına bakın.
Maliyet üzerindeki en büyük etken geçmiş uzunluğudur. Saklanan dönüş sayısını iki katına çıkarırsanız, giriş token'ları da kabaca iki katına çıkar. Bunları sınırlandırın ve her çağrıdan sonra kalan bakiyenizi bildiren X-Balance-USD yanıt başlığını izleyin. Bunu günlüğe kaydedebilir ve botunuz, bakiye bir eşik altına düştüğünde bir yönetici kanalına uyarı yayınlamasını sağlayabilirsiniz.
Sorun Giderme
Bot çevrimiçi ancak hiç yanıt vermiyor: Mesaj İçeriği niyetinin devre dışı bırakılmış olması genellikle bunun nedenidir. Geliştirici portalında ve kodda (yukarıda gösterildiği gibi) bunu etkinleştirin.
Yük altında 429 hataları görürsünüz: semaforu düşürün, dönen hata kodunu kontrol edin ve geri çekilin. Kod rate_limited ise, dakikada çok fazla istek gönderiyorsunuz. Kod concurrency ise, aynı anda çok fazla istek uçta.
Yanıtlar düz ve cansız geliyor: temperature değerini 1.0'a doğru artırın, karakterin konuşma örneklerini sistem istemine ekleyin ve tekrarlayan ifadeleri durdurmak için küçük bir frequency_penalty deneyin. Bu parametreler modele doğrudan iletilir.
Yanıtlar kesilir: Discord'un 2.000 karakter limiti genellikle sebeptir. Uzun yanıtları birkaç mesaja bölün veya daha kısa isteklerde bulunun. İstek seçenekleri hakkında daha derinlemesine bilgi için API hızlı başlangıç kılavuzunu okuyun ve karakter odaklı bir bot inşa ediyorsanız, AI arkadaş API sayfası kişilik tasarımını daha ayrıntılı ele alır.
Daha fazla kılavuz
Sorular ve cevaplar
Sansürsüz bir Discord botu için özel bir kütüphaneye mi ihtiyacınız var?
Hayır. Discord için discord.py (veya discord.js) ve model için normal OpenAI SDK'sını kullanın. Sadece base URL, anahtar ve model ID uncensored değişir.
Bot resim veya ses yanıtları oluşturabilir mi?
Hayır. API yalnızca metin içindir; görüntü, ses veya video oluşturma ve gömme yoktur.
Botla aynı anda kaç kullanıcı sohbet edebilir?
Tam bir anahtar eşzamanlı 8 istek ve dakikada 300 istek sağlar. Ek istekleri botunuzda kuyruğa alın ve HTTP 429 durumunda yeniden deneyin.
Bunu test etmek için ücretsiz bir yol var mı?
Evet. Kayıt olduktan sonra API anahtarı sayfasında tek tıkla $0,50 deneme kredisi talep edebilirsiniz. 7 gün geçerlidir, kişi başı bir kez.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.
API anahtarı al