更新日:
フィルターなしAI Discordボット:Pythonで構築
AIガールフレンドAPIは、大規模言語モデルを使用してロマンチックまたは相棒のような相互作用をシミュレートするチャットアプリケーション向けの専用インターフェースです。このガイドでは、標準的なコンテンツ拒否なしでロールプレイのコンテキストを処理する無検閲モデルに焦点を当てた技術的アプローチを比較します。

あなたが構築しているもの
このようなボットは、合法的な成人向けリクエストを拒否しない言語モデルからの返信を行う通常のDiscordボットです。ボットはメンションまたはスラッシュコマンドを待ち受け、会話をchat-completionsエンドポイントに送信し、回答をチャンネルに投稿します。Discord側の処理は通常どおりです。典型的なチュートリアルとの唯一の違いは、テキストの供給元です。
このAPIはOpenAI互換なので、特別なクライアントは必要ありません。Base URLとAPIキーを変更すれば、任意のOpenAI SDKが動作します。モデルIDはuncensoredです。これは独立したプロバイダが運営する単一のオープンウェイトモデルで、合法的な成人利用においてコンテンツ拒否なしで回答するように調整されています。テキストのみ対応のため、ボットはチャット、小説の作成、テキストゲームの実行、キャラクターの演技が可能ですが、画像や音声は生成しません。
ボットの構成方法にかかわらず、変更されないルールが1つあります。それは未成年者が関わる性的コンテンツの禁止です。それ以外では、Discord独自の利用規約とコミュニティガイドラインがあり、これらはあなたのボットとサーバーに適用されます。年齢制限のあるチャンネルに成人向けボットを配置し、ユーザーにボットの用途を伝えることを計画してください。
開始前に
4つのものが必要です:Discordアカウント、Python 3.10以降、APIキー、およびボットを追加する権限を持つサーバー。
- Discord開発者ポータルを開き、アプリケーションを作成し、ボットユーザーを追加してトークンをコピーします。そのトークンはパスワードのように扱ってください。
- ボットページでメッセージコンテンツのインテントを有効にします。これを有効にしないと、ボットは空のテキストを持つメッセージを受信します。
botスコープとメッセージの読み取り・送信権限でボットをサーバーに招待します。- API キーページでAPIキーを作成します。新規ユーザーはサインアップ後にワンクリックで$0.50の無料トライアルクレジットを受け取ることができます。有効期限は7日で、上記のすべての機能を初めてテストするために使用できます。
2つのライブラリをインストールします:
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"])
ここで重要な点が2つあります。Discordは2,000文字を超えるメッセージを拒否するため、コードではシステムプロンプトで短い応答を要求し、安全策として1,900文字でテキストを切り詰めます。また、max_tokensはこのAPIではオプションですが、これを設定することで、想定外のコストがかかるような応答の暴走を防ぐことができます。
チャンネルごとのメモリを追加
メモリがないボットは2つのメッセージの後には壊れたように感じられます。解決策は、各チャンネルの最近のターンを短いリストとして保持し、すべてのリクエストに含めることです。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を持つdequeは、古いターンを自動的に削除します。16ターンは適切な開始点です。コンテキストウィンドウは100,000トークンなので、はるかに多く保持できますが、追加のターンごとに後続のリクエストで入力として請求されます。より長いメモリは技術的な制限ではなく、プロダクトの判断です。
長時間実行されるキャラクター
キャラクターが数週間にわたって事実を記憶する必要がある場合は、チャンネルごとに短い要約をファイルまたはデータベースに保存し、それをシステムプロンプトに追加します。モデル自体に30ターンごとに要約を更新させるように依頼します。これにより、プロンプトは小さく保たれ、キャラクターは名前、継続中のジョーク、プロットポイントを記憶し続けます。
レート制限内に留まる
通常のAPIキーでは8つの同時リクエストと1分あたり300件のリクエストが可能です。トライアルキーでは2つの同時リクエストと1分あたり60件のリクエストが可能です。単一の静かなサーバーではこれらの数字に達することは決してありませんが、人気のあるチャンネルでは同じ秒内に複数のメンションが送信される可能性があります。
最も単純なガードは、同時実行数の制限を下回るように同時呼び出しを制限するセマフォと、偶発的な429に対する再試行です。APIはHTTP 429とエラーコードで問題をシグナルします。rate_limitedは1分あたりのリクエストが多すぎること、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はメッセージの更新頻度に制限があるため、すべてのトークンで更新するのではなく、約1秒ごとにテキストを更新してください。ほとんどのボットでは、通常の非ストリーミング返信とタイピングインジケーターの方が単純で、問題なく動作します。
スラッシュコマンド、ペルソナ、サーバーのルール
メンションは開始する最も速い方法ですが、スラッシュコマンドはユーザーによりクリーンなインターフェースを提供します。discord.app_commandsを使用すると、システムプロンプトを切り替える/persona、チャンネル履歴をクリアする/reset、保存された要約を表示する/summaryを追加できます。各コマンドは、上記のプロンプトと履歴の辞書のみを編集します。
サーバーを健全に保つためのいくつかの実用的な習慣:
- 成人向けボットは年齢制限が指定されたチャンネルでのみ実行し、チャンネルのトピックでそれを明記してください。
- キャラクターの概要と境界をシステムプロンプトに含め、短く保ってください。モデルは長いルールブックよりも明確な150語の概要の方がよく従います。
- リクエストIDをログに記録します。すべての応答には
X-Request-Idヘッダーが含まれており、単独の奇妙な応答を追跡する必要がある場合に役立ちます。 - モデルもそのルールに縛られているにもかかわらず、自分のコードに未成年者を性的に描写するリクエストを拒否する堅固なルールを追加します。APIはそれを提供せず、ボットも試みるべきではありません。
APIに送信されるプロンプトはトレーニングに使用されないため、メンバーが個人的なことをチャットする場合、サーバーのルールでこれを明記する価値があります。ボットは履歴に入力したものをすべて保存するため、どの程度保持するかを決定し、人に伝えてください。
実行コスト
料金は前払いクレジットから、入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50で、サブスクリプションはありません。失敗または拒否されたリクエストは請求されず、クレジットは期限切れになりません。現実的なチャットターン:履歴16ターンとシステムプロンプトは約1,500入力トークンに相当し、返信は約300トークンです。
| パート | トークン | レート | コスト |
|---|---|---|---|
| 入力 | 1,500 | 100万トークンあたり$0.15 | $0.000225 |
| 出力 | 300 | 100万トークンあたり$0.50 | $0.000150 |
| 1件の応答 | $0.000375 |
1,000回の応答で$0.375、10,000回で$3.75かかります。最小額の$20チャージでは、そのサイズで53,000回以上の応答をカバーできます。チャージは$20から$500までドル単位で可能で、$50以上で5%、$100以上で10%、$200以上で15%のボーナスが付きます。このサイトでは暗号資産のみを受け付けています:TRC20上のUSDTまたはBase上のUSDC。詳細は価格ページをご覧ください。
コストに対する最大のレバーは履歴の長さです。保持するターンを2倍にすると、入力トークンもほぼ2倍になります。それらを制限し、X-Balance-USD応答ヘッダーを監視してください。これは各呼び出し後の残高を報告します。これをログに記録し、閾値を下回ったときにボットが管理者チャンネルに警告を投稿するようにできます。
トラブルシューティング
ボットはオンラインですが返信しない:メッセージコンテンツのインテントが原因であることがほとんどです。開発者ポータルとコードの両方で有効にしてください(上記参照)。
負荷下で429エラーが表示される場合は、セマフォの値を下げ、返されたエラーコードを確認し、バックオフしてください。コードがrate_limitedの場合、1分あたりのリクエスト数が多すぎます。concurrencyの場合、同時に実行中のリクエストが多すぎます。
返信が単調に感じられる:temperatureを1.0に近づけ、キャラクターの会話の例を2〜3行システムプロンプトに追加し、繰り返しのフレーズを止めるために小さなfrequency_penaltyを試してください。これらのパラメータはモデルに渡されます。
返信が切り捨てられる:Discordの2,000文字の制限が通常の原因です。長い回答を複数のメッセージに分割するか、短い回答を依頼してください。リクエストオプションの詳細については、APIクイックスタートをお読みください。キャラクター駆動型のボットを構築している場合は、AIコンパニオンAPIページでペルソナ設計についてさらに詳しく説明しています。
その他のガイド
質問と回答
無検閲のDiscordボットには特別なライブラリが必要ですか?
いいえ。Discordにはdiscord.py(またはdiscord.js)を、モデルには通常のOpenAI SDKを使用してください。変更されるのはベースURL、APIキー、モデルID uncensoredだけです。
ボットは画像や音声の返信を生成できますか?
いいえ。このAPIはテキストのみで、画像、音声、動画の生成や埋め込みはサポートしていません。
同時に何人のユーザーがボットとチャットできますか?
フルキーでは同時8リクエスト、1分あたり300リクエストが可能です。追加のリクエストはボットでキューに入れ、HTTP 429時に再試行してください。
無料でテストする方法はありますか?
はい。サインアップ後、API キーページでワンクリックで$0.50の無料トライアルクレジットを受け取ることができます。有効期限は7日で、1人あたり1回限りです。
キーはフォーム 1 つで手に入ります
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。
API キーを取得