更新於
無審查 AI Discord 機器人:使用 Python 建置
AI女友API提供專門介面,用於透過大型語言模型模擬浪漫或伴侶互動的聊天應用程式。本指南比較技術方法,專注於處理角色扮演上下文且無標準內容拒絕的無審查模型。

你要建置的內容
此類機器人是一般 Discord 機器人,其回覆來自不會拒絕合法成人請求的語言模型。機器人監聽提及或斜線指令,將對話傳送至 chat-completions 端點,並將答案貼回頻道。Discord 端沒有任何變更。與一般教學唯一的差異在於文字來源。
此 API 與 OpenAI 相容,因此你不需要特殊的客戶端。只要更改 Base URL 和金鑰,任何 OpenAI SDK 都可以運作。模型 ID 為 uncensored。這是一個由獨立供應商運營的單一開放權重模型,經過調整以在合法成人用途下無內容拒絕地回答。它僅支援文字,因此機器人可以聊天、撰寫小說、運行文字遊戲並扮演角色,但無法生成影像或音訊。
無論如何設定機器人,有一條規則保持不變:禁止涉及未成年人的性內容。除此之外,Discord 有其自身的條款與社群指南,這些規範適用於你的機器人與伺服器。建議將成人主題機器人放在年齡限制頻道,並告知使用者該機器人的用途。
開始之前
你需要四樣東西:Discord 帳號、Python 3.10 或更新版本、API 金鑰,以及你有權限新增機器人的伺服器。
- 開啟 Discord 開發者入口網站,建立應用程式,新增機器人使用者並複製其 token。將該 token 視為密碼。
- 在機器人頁面,開啟「訊息內容」意圖(Message Content intent)。若未開啟,你的機器人接收到的訊息文字將為空。
- 使用
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 的雙端佇列會自動移除最舊的對話輪次。十六個輪次是一個合理的起點。上下文視窗為 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 的提示詞不會用於訓練,如果你的成員在聊天中討論個人事務,這值得在伺服器規則中說明。你的機器人也會儲存你放入歷史記錄的任何內容,因此請決定保留多久並告知使用者。
運行成本
定價為每 100 萬個輸入 token $0.15,每 100 萬個輸出 token $0.50,從預付額度扣除且無訂閱費。失敗或被拒絕的請求不會收費,且額度永不過期。以下是一個實際的聊天回合範例:16 回合的歷史記錄加上系統提示詞約為 1,500 個輸入 token,回覆約為 300 個 token。
| 部分 | Token | 費率 | 成本 |
|---|---|---|---|
| 輸入 | 1,500 | $0.15 / 1M | $0.000225 |
| 輸出 | 300 | $0.50 / 1M | $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 請使用 discord.py(或 discord.js),對於模型則使用一般的 OpenAI SDK。僅需更改 Base URL、金鑰和模型 ID uncensored。
機器人可以產生圖片或語音回覆嗎?
否。該 API 僅支援文字,不支援影像、音訊或影片生成,也不支援嵌入。
同時可以有多少使用者與機器人聊天?
完整金鑰允許 8 個並行請求與每分鐘 300 個請求。在機器人中排隊額外的請求,並在 HTTP 429 時重試。
有免費測試的方法嗎?
可以。註冊後,你可以在 API 金鑰頁面一鍵領取 $0.50 的免費試用額度。有效期為 7 天,每人限領一次。
只差一張表單,即可取得金鑰
建立帳號、複製金鑰、更改Base URL。這就是整個設定過程。
取得 API 金鑰