繁中 ▾
nofilterai.top
NoFilter AI
取得 API 金鑰

無審查 AI Discord 機器人:使用 Python 建置

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

等距插圖:聊天氣泡從機器人流向訊息面板,代表 Discord 機器人

你要建置的內容

此類機器人是一般 Discord 機器人,其回覆來自不會拒絕合法成人請求的語言模型。機器人監聽提及或斜線指令,將對話傳送至 chat-completions 端點,並將答案貼回頻道。Discord 端沒有任何變更。與一般教學唯一的差異在於文字來源。

此 API 與 OpenAI 相容,因此你不需要特殊的客戶端。只要更改 Base URL 和金鑰,任何 OpenAI SDK 都可以運作。模型 ID 為 uncensored。這是一個由獨立供應商運營的單一開放權重模型,經過調整以在合法成人用途下無內容拒絕地回答。它僅支援文字,因此機器人可以聊天、撰寫小說、運行文字遊戲並扮演角色,但無法生成影像或音訊。

無論如何設定機器人,有一條規則保持不變:禁止涉及未成年人的性內容。除此之外,Discord 有其自身的條款與社群指南,這些規範適用於你的機器人與伺服器。建議將成人主題機器人放在年齡限制頻道,並告知使用者該機器人的用途。

開始之前

你需要四樣東西:Discord 帳號、Python 3.10 或更新版本、API 金鑰,以及你有權限新增機器人的伺服器。

  1. 開啟 Discord 開發者入口網站,建立應用程式,新增機器人使用者並複製其 token。將該 token 視為密碼。
  2. 在機器人頁面,開啟「訊息內容」意圖(Message Content intent)。若未開啟,你的機器人接收到的訊息文字將為空。
  3. 使用 bot 範圍邀請機器人加入你的伺服器,並賦予其讀取與發送訊息的權限。
  4. 在 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 金鑰