更新于
无审查 AI Discord 机器人:使用 Python 构建
AI 女友 API 为聊天应用提供专用接口,利用大型语言模型模拟浪漫或伴侣式互动。本指南对比了技术方法,重点关注能处理角色扮演上下文且不会产生标准内容拒绝的无审查模型。

你正在构建的内容
此类机器人是一个普通的 Discord 机器人,其回复来自不拒绝合法成人请求的语言模型。机器人监听提及或斜杠命令,将对话发送到 chat-completions 接口,并将答案发布回频道。Discord 端没有任何变化。与典型教程的唯一区别在于文本来源。
该 API 兼容 OpenAI,因此你无需使用专用客户端。只需更改 Base URL 和 API 密钥,任何 OpenAI SDK 均可使用。模型 ID 为 uncensored。它是由独立提供商运营的单一开放权重模型,经过调优,可在合法成人用途中无内容审查地回答。它仅支持文本,因此机器人可以聊天、创作小说、运行文字游戏并扮演角色,但无法生成图片或音频。
无论如何配置机器人,有一条规则保持不变:禁止任何涉及未成年人的性内容。此外,Discord 有自己的条款和社区指南,它们适用于你的机器人和你的服务器。计划将成人主题机器人放在年龄受限的频道中,并告知用户机器人的用途。
开始之前
你需要四样东西:一个 Discord 账户、Python 3.10 或更高版本、一个 API 密钥,以及一个你有权添加机器人的服务器。
- 打开 Discord 开发者门户,创建一个应用,添加一个机器人用户并复制其 token。将该 token 视为密码。
- 在机器人页面,开启 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
在每个用户行前加上显示名称,可以让模型在繁忙的频道中区分发言者。带有 maxlen 的双端队列会自动丢弃最旧的对话轮次。16 轮是一个合理的起点。上下文窗口为 100,000 token,因此你可以保留更多,但每个额外的轮次都会作为输入在后续每个请求中计费。更长的记忆是产品决策,而非技术限制。
长期运行的角色
如果角色需要在数周内记住事实,请在文件或数据库中按频道存储简短摘要,并将其添加到系统提示词中。让模型本身每 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."
如果你流式输出回复并在 token 到达时编辑 Discord 消息,请记住流式请求会占用其并发槽位,直到流结束。流式传输感觉更快,但 Discord 限制你编辑消息的频率,因此每秒更新一次文本,而不是在每个 token 上更新。对于大多数机器人,普通的非流式回复加上打字指示器更简单且效果良好。
斜杠命令、人设和服务器规则
提及是启动最快的方式,但斜杠命令为用户提供更清晰的界面。使用 discord.app_commands,你可以添加 /persona 来切换系统提示词,/reset 来清除频道历史,以及 /summary 来打印保存的摘要。每个命令仅编辑上面显示的提示词和历史字典。
一些保持服务器健康的实用习惯:
- 仅在标记为年龄受限的频道中运行成人主题机器人,并在频道主题中说明。
- 将角色简介和边界放入系统提示词,并保持简短。模型遵循清晰的 150 词简介的效果优于长篇规则手册。
- 记录请求 ID。每个响应都带有
X-Request-Id标头,这在需要追踪单个奇怪回复时很有帮助。 - 在你的代码中添加一条硬性规则,拒绝任何涉及对未成年人进行性化描写的请求,即使模型也受该规则约束。API 不会提供它,你的机器人也不应尝试。
发送到 API 的提示词不用于训练,如果你的成员在聊天中谈论个人事情,这在服务器规则中值得说明。你的机器人还存储你放入历史记录中的所有内容,因此决定保留多长时间并告知人们。
运行成本
定价为每 1M 输入 token $0.15,每 1M 输出 token $0.50,来自预付额度,无订阅。失败或被拒绝的请求不收费,且额度永不失效。以下是一个典型的对话轮次:16 轮历史记录加上系统提示词大约产生 1,500 个输入 token,回复大约为 300 个 token。
| 部分 | Token | 费率 | 成本 |
|---|---|---|---|
| 输入 | 1,500 | 每 100 万 $0.15 | $0.000225 |
| 输出 | 300 | 每 100 万 $0.50 | $0.000150 |
| 一次回复 | $0.000375 |
一千次回复花费 $0.375。一万次回复花费 $3.75。$20 充值(最小金额)可覆盖略多于 53,000 次该规模的回复。充值金额为 $20 至 $500 的整数,从 $50 起有 5% 的额外赠送,从 $100 起有 10% 的额外赠送,从 $200 起有 15% 的额外赠送。本站仅接受加密货币:TRC20 上的 USDT 或 Base 上的 USDC。详见定价页面。
影响成本的最大杠杆是历史长度。如果你保留的对话翻倍,输入 token 也大致翻倍。限制它们,并监控 X-Balance-USD 响应标头,该标头报告每次调用后的剩余余额。你可以记录它,并在余额低于阈值时让机器人在管理频道中发布警告。
故障排除
机器人在线但从不回复:原因通常是未启用消息内容意图。请在开发者门户和代码中启用它,如上所示。
在负载下看到 429 错误:降低信号量,检查返回的错误代码,并退避。如果代码是 rate_limited,则你每分钟发送的请求过多。如果是 concurrency,则同时进行的请求过多。
回复显得平淡:将temperature调高至 1.0,在系统提示词中加入两到三行角色台词示例,并尝试设置较小的frequency_penalty以阻止重复短语。这些参数会直接传递给模型。
回复被截断:Discord 的 2,000 字符限制通常是原因。将长答案拆分为多条消息,或要求更短的答案。有关请求选项的更深入查看,请阅读 API 快速入门,如果你正在构建以角色为中心的机器人,AI 伴侣 API 页面 更详细地介绍了人设设计。
更多指南
问答
无审查的 Discord 机器人是否需要专用库?
不需要。使用 discord.py(或 discord.js)处理 Discord 交互,并使用标准的 OpenAI SDK 调用模型。仅需更改 Base URL、API 密钥和模型 ID uncensored。
机器人能否生成图片或语音回复?
不能。该接口仅支持文本,不支持图像、音频或视频生成,也不支持嵌入向量。
同时有多少用户可以与机器人聊天?
完整密钥允许 8 个并发请求和每分钟 300 个请求。在机器人中排队额外请求,并在 HTTP 429 时重试。
有免费测试的方法吗?
可以。注册后,你可以在 API 密钥页面一键领取 $0.50 的免费试用额度。有效期为 7 天,每人限领一次。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改Base URL。这就是全部设置。
获取 API 密钥