ホーム / ガイド / DiscordまたはTelegramボット向けの無料AI API

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 は、モデルを速度で並べます。チャットのユーザーの待ち時間が短くなります。
  • 失敗時は丁寧に伝えます。すべてのキーが上限に達したら、ユーザーに後でもう一度試すよう伝えてください。
プライバシー: ボットは、ユーザーのメッセージを、回答したプロバイダーに送ります。一部の無料枠は、プロンプトをモデルの改善に使うことがあります。ユーザーには、AIサービスがメッセージを読むことを伝えてください。どの無料LLM APIがデータで学習するかを読み、受け入れられないプロバイダーをチェーンから削除してください。

次の無料モデルは、現在、実測の速度が最も速いモデルです。多くは高いリクエスト上限を持ちます:

高速な無料チャットモデル
モデル無料で利用可能コンテキスト無料枠の上限(最良の条件)ツール画像入力
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo ほか 3 件262K30 リクエスト/分
250 リクエスト/日
70,000 トークン/分
~6M
はいはい
GPT-OSS 20BApi.Airforce, Cloudflare Workers AI, Groq ほか 4 件131K30 リクエスト/分
1,000 リクエスト/日
8,000 トークン/分
200,000 トークン/日
~6M
はいいいえ
Nemotron 3.5 LightningElectronHub, Gizmo, Kilo Gateway ほか 2 件1M20 リクエスト/分
50 リクエスト/日
50 req/day account-wide (1,000 after a $10 purchase)
はいいいえ
GPT-OSS 120BCloudflare Workers AI, ElectronHub, Groq ほか 1 件131K30 リクエスト/分
1,000 リクエスト/日
8,000 トークン/分
200,000 トークン/日
~6M
はいいいえ
GPT-OSS 20B (via Groq)DreamPrompting131K100 リクエスト/分
5,000 リクエスト/日
500,000 トークン/日
500K tokens/day · 5,000 req/day
いいえいいえ
GPT-OSS Safeguard 20BGroq131K30 リクエスト/分
1,000 リクエスト/日
8,000 トークン/分
200,000 トークン/日
~6M
はいいいえ
Groq Compound MiniDreamPrompting131K100 リクエスト/分
5,000 リクエスト/日
500,000 トークン/日
500K tokens/day · 5,000 req/day
いいえいいえ
Gemini 3.5 Flash LiteElectronHub, Google AI Studio1M15 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
Step 3.7 FlashElectronHub256K$0.25/week shared recurring creditはいはい
Gemini 3.1 Flash-LiteDreamPrompting, Google AI Studio1M100 リクエスト/分
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ボット

  1. Discord Developer Portalを開き、アプリケーションを作成します。ボットを追加し、そのトークンをコピーします。
  2. ボットのタブで、Privileged Gateway Intents に移動します。Message Content をオンにしてください。
  3. bot スコープと Send Messages の権限で、ボットをサーバーに招待します。
  4. トークンを 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ボット

  1. Telegramで @BotFather を開き、/newbot を送ります。トークンをコピーします。
  2. トークンを TELEGRAM_TOKEN 環境変数に設定します。
  3. スクリプトを実行します。ボットにメッセージを送ってください。

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 に対応し、設定を変更する前にバックアップを作成します。

エージェントセットアップコマンド書き込まれる内容
OpenClawnpx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key>freellmapi プロバイダーを ~/.openclaw/openclaw.json に書き込みます。既定のモデルは freellmapi/auto
Hermes Agentnpx 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ネットワークを使ってください
これらすべてを 1 つのキーで利用できます。 FreeLLMAPI は、オープンソースのセルフホスト型ルーターです。これらの無料枠すべてを 1 つの OpenAI 互換エンドポイントの背後にまとめ、レート制限に達した場合は自動的に別のプロバイダーへ切り替えます。 カタログを見る または 公開.

よくある質問

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を返します。ボットのコードはそれを捕捉し、後でもう一度試すようユーザーに伝えます。

関連ガイド

出典

すべてのガイド · 無料モデルをすべて見る