Обновлено
Бот для Discord без фильтров: создание на Python
API для ИИ-подруги предоставляет специализированный интерфейс для чат-приложений, имитирующих романтическое или компаньонское взаимодействие с помощью больших языковых моделей. Это руководство сравнивает технические подходы, уделяя особое внимание моделям без цензуры, которые обрабатывают контекст ролевой игры без стандартных отказов.

Что вы создаёте
Бот такого типа — это обычный бот Discord, ответы которого генерируются языковой моделью, не отказывающейся от законных запросов взрослых пользователей. Бот слушает упоминания или слэш-команду, отправляет диалог в эндпоинт chat-completions и публикует ответ обратно в канал. Со стороны Discord ничего не меняется. Единственное отличие от типичного руководства — источник текста.
Этот API совместим с OpenAI, поэтому вам не нужен специальный клиент. Любой SDK OpenAI работает после изменения базового URL и ключа. Идентификатор модели — uncensored. Это одна из моделей с открытыми весами от независимого провайдера, настроенная на ответы без отказов по контенту для законного использования взрослыми. Модель работает только с текстом: бот может общаться, писать художественные тексты, запускать текстовые игры и отыгрывать роли, но не генерирует изображения или аудио.
Одно правило остается неизменным независимо от конфигурации бота: запрет на сексуальный контент с участием несовершеннолетних. Кроме того, у Discord есть свои условия использования и правила сообщества, которые применяются к вашему боту и вашему серверу. Рекомендуется размещать ботов с контентом для взрослых в каналах с ограничением по возрасту и сообщать пользователям, для чего предназначен бот.
Перед началом
Вам понадобятся четыре вещи: аккаунт Discord, Python 3.10 или новее, API-ключ и сервер, где у вас есть разрешение на добавление бота.
- Откройте портал разработчика Discord, создайте приложение, добавьте пользователя-бота и скопируйте его токен. Относитесь к этому токену как к паролю.
- На странице бота включите намерение Message Content. Без него ваш бот будет получать сообщения с пустым текстом.
- Пригласите бота на свой сервер с областью
botи разрешением на чтение и отправку сообщений. - Создайте API-ключ на странице API-ключа. Новые пользователи могут получить $0,50 пробного кредита одним нажатием после регистрации. Он действителен в течение 7 дней и подходит для первого тестирования всего, что описано ниже.
Установите две библиотеки:
pip install discord.py openai
export DISCORD_TOKEN="your-discord-bot-token"
export NOFILTER_API_KEY="your-api-key"
Храните оба значения в переменных среды или в менеджере секретов. Никогда не вставляйте их в файл, который попадает в публичный репозиторий.
Минимальный бот
Первая версия отвечает, когда кто-то упоминает бота. Она использует асинхронный клиент OpenAI, чтобы цикл событий Discord не блокировался, пока модель генерирует ответ.
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"])
Здесь важны две детали. Discord отклоняет сообщения длиннее 2 000 символов, поэтому код запрашивает короткий ответ в системном промпте и разбивает текст на части по 1 900 символов как страховку. max_tokens в этом API опционален, но его установка не позволяет ответу стоить дороже, чем вы планировали.
Добавьте память для каждого канала
Бот без памяти кажется сломанным после двух сообщений. Решение — хранить короткий список последних реплик для каждого канала и отправлять его с каждым запросом. API не сохраняет состояние, поэтому история полностью в вашем управлении.
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
Префикс с отображаемым именем пользователя позволяет модели различать говорящих в загруженном канале. Дек (deque) с параметром maxlen автоматически удаляет самые старые реплики. Шестнадцать реплик — это разумное начало. Контекстное окно рассчитано на 100 000 токенов, поэтому можно хранить гораздо больше, но каждая дополнительная реплика оплачивается как входные данные в каждом последующем запросе. Увеличение памяти — это продуктовое решение, а не техническое ограничение.
Долгоживущие персонажи
Если персонажу нужно помнить факты в течение недель, храните краткую сводку по каждому каналу в файле или базе данных и добавляйте её в системный промпт. Попросите модель обновлять сводку каждые 30 или около того реплик. Это поддерживает промпт в компактном виде, пока персонаж помнит имена, внутренние шутки и сюжетные повороты.
Оставайтесь в пределах лимитов запросов
Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту. Пробный ключ позволяет 2 параллельных запроса и 60 в минуту. Один тихий сервер никогда не достигнет этих цифр, но популярный канал может отправить несколько упоминаний за одну секунду.
Самая простая защита — семафор, ограничивающий параллельные вызовы ниже лимита параллелизма, плюс повторная попытка для редких 429. API сигнализирует о проблемах кодом HTTP 429 и кодом ошибки: rate_limited означает слишком много запросов в минуту, concurrency означает слишком много одновременно. При временной перегрузке он также отправляет 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."
Если вы используете потоковую передачу ответов и редактируете сообщение в Discord по мере поступления токенов, помните, что потоковый запрос удерживает слот параллельных запросов до завершения потока. Потоковая передача кажется быстрее, но Discord ограничивает частоту редактирования сообщений, поэтому обновляйте текст примерно каждую секунду, а не при каждом токене. Для большинства ботов достаточно обычного ответа без потоковой передачи и индикатора набора текста.
Команды, персонажи и правила сервера
Упоминания — самый быстрый способ начать, но слэш-команды дают пользователям более чистый интерфейс. С помощью discord.app_commands вы можете добавить /persona для смены системного промпта, /reset для очистки истории канала и /summary для вывода сохраненного резюме. Каждая команда просто редактирует словарь промптов и историй, показанный выше.
Несколько практических привычек сохраняют здоровье сервера:
- Запускайте ботов с контентом для взрослых только в каналах с пометкой «ограничение по возрасту» и указывайте это в теме канала.
- Добавьте краткое описание персонажа и границы в системный промпт и держите его коротким. Модели лучше следуют чёткому описанию на 150 слов, чем длинному своду правил.
- Логируйте идентификаторы запросов. Каждый ответ содержит заголовок
X-Request-Id, что помогает отследить один странный ответ. - Добавьте жесткое правило в свой код, которое отказывает в любом запросе, сексуализирующем несовершеннолетних, даже если модель также связана этим правилом. API не предоставит его, и ваш бот не должен пытаться.
Промпты, отправленные в API, не используются для обучения, что стоит указать в правилах сервера, если ваши участники общаются о личных вещах. Ваш бот также хранит все, что вы помещаете в историю, поэтому решите, как долго её хранить, и сообщите об этом людям.
Стоимость использования
Стоимость составляет $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов, списывается с предоплаченного баланса без подписки. За отклонённые или неудачные запросы не взимается плата, а баланс не сгорает. Вот реалистичный пример диалога: 16 реплик истории плюс системный промпт составляют около 1 500 входных токенов, а ответ — около 300 токенов.
| Часть | Токены | Ставка | Стоимость |
|---|---|---|---|
| Входные | 1 500 | $0,15 за 1 млн | $0,000225 |
| Выходные | 300 | $0,50 за 1 млн | $0,000150 |
| Один ответ | $0,000375 |
Тысяча ответов стоит $0,375. Десять тысяч — $3,75. Пополнение на $20, минимальная сумма, покрывает чуть более 53 000 ответов такого объёма. Пополнения — от $20 до $500 целыми долларами, с бонусом 5% от $50, 10% от $100 и 15% от $200. Этот сайт принимает только криптовалюту: USDT в сети TRC20 или USDC в сети Base. Подробности см. на странице с ценами.
Главный рычаг влияния на стоимость — длина истории. Если вы удвоите количество сохраняемых реплик, входные токены примерно удвоятся. Ограничьте их и следите за заголовком ответа X-Balance-USD, который сообщает о вашем оставшемся балансе после каждого вызова. Вы можете логировать его и заставить бота публиковать предупреждение в канале администраторов, когда баланс упадет ниже порога.
Устранение неполадок
Бот онлайн, но никогда не отвечает: почти всегда причиной является отсутствие намерения Message Content. Включите его в портале разработчика и в коде, как показано выше.
При нагрузке вы видите ошибки 429: уменьшите семафор, проверьте, какой код ошибки вернулся, и подождите перед повтором (backoff). Если код rate_limited, вы отправляете слишком много запросов в минуту. Если код concurrency, одновременно выполняется слишком много запросов.
Ответы кажутся плоскими: увеличьте значение temperature ближе к 1,0, добавьте два-три примера реплик персонажа в системный промпт и попробуйте небольшой frequency_penalty, чтобы избежать повторения фраз. Эти параметры передаются модели напрямую.
Ответы обрываются: обычно это ограничение Discord в 2 000 символов. Разбивайте длинные ответы на несколько сообщений или просите более короткие. Подробнее об опциях запроса см. в быстром старте API, а если вы создаёте бота с привязкой к образу, на странице API AI-компаньона подробнее описано создание образа.
Дополнительные руководства
Вопросы и ответы
Нужна ли специальная библиотека для Discord-бота без фильтров?
Нет. Используйте discord.py (или discord.js) для Discord и стандартный OpenAI SDK для модели. Изменяются только базовый URL, ключ и идентификатор модели uncensored.
Может ли бот генерировать изображения или голосовые ответы?
Нет. API работает только с текстом, без генерации изображений, аудио или видео и без эмбеддингов.
Сколько пользователей могут одновременно общаться с ботом?
Полный ключ позволяет выполнять 8 одновременных запросов и 300 запросов в минуту. Добавляйте дополнительные запросы в очередь в вашем боте и повторяйте попытку при HTTP 429.
Есть ли бесплатный способ протестировать?
Да. После регистрации вы можете получить $0,50 пробного кредита одним кликом на странице API-ключа. Он действителен в течение 7 дней, один на человека.
Ваш ключ — всего в одной форме
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.
Получить API-ключ