DiscordまたはTelegramボット向けの無料AI API
チャットボットは、メッセージごとにモデルへのリクエストを1回送ります。混み合ったサーバーでは、1つの無料枠が数分で上限に達することがあります。このガイドでは、DiscordボットとTelegramボットをFreeLLMAPIに接続します。FreeLLMAPIは、45 個のプロバイダーの無料枠を、1つのOpenAI互換キーの背後にまとめます。上限によってリクエストが止まると、次のプロバイダーに切り替えます。コードはPythonで、完全なものです。
コード、モデル名、ライブのカタログラベルは英語で表示します。
まず上限を計画する
無料枠では、1分あたりと1日あたりのリクエスト数が制限されます。アクティブなユーザーが200人いるサーバーのボットは、1日に数千件のリクエストを送ることがあります。フェイルオーバーでこれらのリクエストを、すべてのキーに分散できますが、合計は無料の上限の合計を超えません。
- 聞かれたときだけ答えます。Discordでは、メンションにだけ答えてください。Telegramのグループでは、コマンドまたは返信にだけ答えてください。
- ユーザーごとに制限します。数秒ごとに、1人のユーザーにつき1リクエストまでにしてください。
- 履歴を短く保ちます。チャンネルの全履歴ではなく、直近の10件のメッセージだけを送ってください。
- 速いルートを使います。
auto:fastは、モデルを速度で並べます。チャットのユーザーの待ち時間が短くなります。 - 失敗時は丁寧に伝えます。すべてのキーが上限に達したら、ユーザーに後でもう一度試すよう伝えてください。
次の無料モデルは、現在、実測の速度が最も速いモデルです。多くは高いリクエスト上限を持ちます:
| モデル | 無料で利用可能 | コンテキスト | 無料枠の上限(最良の条件) | ツール | 画像入力 |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo ほか 3 件 | 262K | 30 リクエスト/分 250 リクエスト/日 70,000 トークン/分 ~6M | はい | はい |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq ほか 4 件 | 131K | 30 リクエスト/分 1,000 リクエスト/日 8,000 トークン/分 200,000 トークン/日 ~6M | はい | いいえ |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway ほか 2 件 | 1M | 20 リクエスト/分 50 リクエスト/日 50 req/day account-wide (1,000 after a $10 purchase) | はい | いいえ |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq ほか 1 件 | 131K | 30 リクエスト/分 1,000 リクエスト/日 8,000 トークン/分 200,000 トークン/日 ~6M | はい | いいえ |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 リクエスト/分 5,000 リクエスト/日 500,000 トークン/日 500K tokens/day · 5,000 req/day | いいえ | いいえ |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 リクエスト/分 1,000 リクエスト/日 8,000 トークン/分 200,000 トークン/日 ~6M | はい | いいえ |
| Groq Compound Mini | DreamPrompting | 131K | 100 リクエスト/分 5,000 リクエスト/日 500,000 トークン/日 500K tokens/day · 5,000 req/day | いいえ | いいえ |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | はい | はい |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 リクエスト/分 5,000 リクエスト/日 500,000 トークン/日 500K tokens/day · 5,000 req/day | はい | はい |
一致する無料モデル 215 件のうち 10 件を表示しています。 すべてのモデルを見る.
FreeLLMAPI カタログのライブデータ(バージョン 2026.11.19、確認日 2026-11-19)。無料枠の上限は頻繁に変わります。カタログは毎日確認されます。
共通のコード: モデル呼び出し
両方のボットは、同じモジュールを使います。チャットごとに短い履歴を保持し、チャットごとに1つのセッションIDを送り、レート制限を処理します。まずFreeLLMAPIをインストールし、ダッシュボードのKeysページから統合キーをコピーしてください。
インストール
curl -fsSL https://freellmapi.co/install.sh | bash
python3 -m pip install -U openai discord.py python-telegram-bot
export FREELLMAPI_API_KEY=<unified-key>brain.py
import asyncio
import os
import time
from collections import defaultdict, deque
import openai
from openai import AsyncOpenAI
llm = AsyncOpenAI(
base_url="http://localhost:3001/v1",
api_key=os.environ["FREELLMAPI_API_KEY"],
max_retries=2,
timeout=60,
)
SYSTEM = "You are a helpful chat bot. Answer in short paragraphs."
history = defaultdict(lambda: deque(maxlen=10)) # chat id -> last 10 messages
last_call = {} # user id -> time of the last request
COOLDOWN_S = 5
async def ask(chat_id: str, user_id: str, text: str) -> str:
now = time.monotonic()
if now - last_call.get(user_id, 0) < COOLDOWN_S:
return "Please wait a few seconds before the next question."
last_call[user_id] = now
turns = history[chat_id]
turns.append({"role": "user", "content": text[:4000]})
messages = [{"role": "system", "content": SYSTEM}, *turns]
for attempt in range(3):
try:
resp = await llm.chat.completions.create(
model="auto:fast",
messages=messages,
max_tokens=800,
extra_headers={"X-Session-Id": f"chat-{chat_id}"},
)
answer = resp.choices[0].message.content or "(no answer)"
turns.append({"role": "assistant", "content": answer})
return answer
except openai.RateLimitError as err:
header = err.response.headers.get("retry-after", "")
wait = int(header) if header.isdigit() else 2 ** attempt
if wait > 30:
break
await asyncio.sleep(wait)
except openai.APIError:
break
turns.pop() # forget the unanswered question
return "All free models are busy now. Please try again later."
def split(text: str, size: int) -> list[str]:
return [text[i:i + size] for i in range(0, len(text), size)] or [""]X-Session-Id ヘッダーは、1つのチャットを30分間同じモデルに割り当てます。そのためボットは、会話の中で同じ口調を保ちます。そのモデルが上限に達すると、ルーターは別のモデルに移り、そのモデルは同じ履歴を受け取ります。
履歴とクールダウンは、メモリに保持されます。ボットを再起動すると失われます。長い会話を覚えておく必要があるボットの場合は、履歴をSQLiteやRedisなどのデータベースに保存してください。
discord.pyを使うDiscordボット
- Discord Developer Portalを開き、アプリケーションを作成します。ボットを追加し、そのトークンをコピーします。
- ボットのタブで、Privileged Gateway Intents に移動します。Message Content をオンにしてください。
botスコープと Send Messages の権限で、ボットをサーバーに招待します。- トークンを
DISCORD_TOKEN環境変数に設定し、スクリプトを実行します。
discord_bot.py
import os
import discord
from brain import ask, split
intents = discord.Intents.default()
intents.message_content = True
client = discord.Client(intents=intents)
@client.event
async def on_ready():
print(f"Logged in as {client.user}")
@client.event
async def on_message(message: discord.Message):
if message.author.bot or client.user not in message.mentions:
return
text = message.content
for tag in (f"<@{client.user.id}>", f"<@!{client.user.id}>"):
text = text.replace(tag, "")
text = text.strip()
if not text:
return
async with message.channel.typing():
answer = await ask(str(message.channel.id), str(message.author.id), text)
parts = split(answer, 2000) # Discord limit: 2000 characters
await message.reply(parts[0])
for part in parts[1:]:
await message.channel.send(part)
client.run(os.environ["DISCORD_TOKEN"])python-telegram-botを使うTelegramボット
- Telegramで @BotFather を開き、
/newbotを送ります。トークンをコピーします。 - トークンを
TELEGRAM_TOKEN環境変数に設定します。 - スクリプトを実行します。ボットにメッセージを送ってください。
telegram_bot.py
import os
from telegram import Update
from telegram.constants import ChatAction
from telegram.ext import Application, ContextTypes, MessageHandler, filters
from brain import ask, split
async def on_text(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
chat_id = update.effective_chat.id
await context.bot.send_chat_action(chat_id=chat_id, action=ChatAction.TYPING)
answer = await ask(str(chat_id), str(update.effective_user.id), update.message.text)
for part in split(answer, 4096): # Telegram limit: 4096 characters
await update.message.reply_text(part)
def main() -> None:
app = Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build()
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, on_text))
app.run_polling(allowed_updates=Update.ALL_TYPES)
if __name__ == "__main__":
main()Telegramの入力中の表示は、5秒以下しか続きません。遅いモデルの場合は、長いリクエストの間に、チャットのアクションを再度送ってください。このコードは、完全に非同期のpython-telegram-botバージョン22を使います。
そのまま使えるボットエージェント
ボットを書きたくない場合は、DiscordとTelegramで応答し、FreeLLMAPIをモデルとして使える2つのエージェントがあります。FreeLLMAPIには、それぞれのセットアップコマンドがあります。各コマンドは --dry-run に対応し、設定を変更する前にバックアップを作成します。
| エージェント | セットアップコマンド | 書き込まれる内容 |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | freellmapi プロバイダーを ~/.openclaw/openclaw.json に書き込みます。既定のモデルは freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | ~/.hermes/config.yaml のカスタムモデルブロック |
実行中のOpenClawまたはHermesのゲートウェイは、セットアップコマンドの後で再起動が必要です。
ボットとFreeLLMAPIは、同じコンピューターまたはサーバーで実行してください。そうすると、ボットは localhost でゲートウェイに届き、ゲートウェイのポートはインターネットに公開されません。小さなサーバーやRaspberry Piで両方を動かすのに十分です。
トラブルシューティング
| 問題 | 原因 | 対処 |
|---|---|---|
| Discordボットが空のメッセージを読む | Message Content のintentがオフ | ポータルと intents.message_content で、オンにしてください |
| ボットが自分のメッセージに答える | ボットの作成者をチェックしていない | message.author.bot が true のとき、返してください |
| 長い回答でDiscordのエラー50035 | メッセージが2000文字を超えています | 上のコードのように、回答を分割してください |
| 夕方の「All free models are busy」 | チェーン内のすべてのキーが1日の上限に達しています | より多くのプロバイダーのキーを追加してください。多くの1日の上限は、UTCの午前0時にリセットされます。 |
| 回答が遅い | 遅いモデル、または長い履歴 | auto:fast を使い、10件以下のメッセージを保持してください |
ボットから Connection refused | ボットはDockerで動作し、localhost を使っている | host.docker.internal または共有のDockerネットワークを使ってください |
よくある質問
Discordボットのための無料AI APIはありますか。
はい。openai Pythonパッケージで動作する無料枠を持つプロバイダーは複数あります。FreeLLMAPIは、それらを1つのキーにまとめるため、混み合ったボットは多くのプロバイダーの上限を使えます。
無料のAI Telegramボットを作れますか。
はい。ボットには python-telegram-bot を、回答にはOpenAI互換の無料APIを使ってください。このページのコードは完全です。
AIボットがレート制限に達しないようにするにはどうすればよいですか。
メンションまたはコマンドにだけ答えてください。ユーザーごとに数秒に1リクエストまでに制限してください。履歴は短く保ち、より多くのプロバイダーのキーを追加してください。
Discordボットのメッセージ内容が空になるのはなぜですか。
Message Content のintentがオフになっています。ポータルのボットのタブでオンにし、コードでは intents.message_content = True を設定してください。
無料モデルがすべて上限に達したらどうなりますか。
FreeLLMAPIは、Retry-After ヘッダー付きのエラー429を返します。ボットのコードはそれを捕捉し、後でもう一度試すようユーザーに伝えます。
関連ガイド
- PythonでのLLM API無料利用
- 無料LLM APIのレート制限
- 無料の OpenAI 互換 API の Base URL
- AIエージェント向けの無料LLM API
- カードなしで使える無料LLM API
出典
- discord.py docs: quickstart (確認日 20 November 2026)
- discord.py docs: privileged intents (確認日 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (確認日 20 November 2026)
- python-telegram-bot v22 docs: echobot example (確認日 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (確認日 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (確認日 20 November 2026)