首页 / 指南 / 用于 Discord 或 Telegram 机器人的免费 AI API

用于 Discord 或 Telegram 机器人的免费 AI API

聊天机器人每收到一条消息就会发送一次模型请求。在繁忙的服务器中,一个免费额度几分钟内就会达到限制。本指南将 Discord 机器人和 Telegram 机器人连接到 FreeLLMAPI。FreeLLMAPI 用一个兼容 OpenAI 的密钥汇集 45 个免费服务商额度,并在某个限制阻止请求时切换到下一个服务商。代码为 Python,且是完整的。

代码、模型名称和目录中的实时标签以英文显示。

先规划限制

免费额度限制每分钟和每天的请求数。一个拥有 200 名活跃用户的服务器中,机器人每天可能发送数千次请求。故障转移会把这些请求分散到你所有的密钥上,但总量仍然是各项免费限制之和。

  • 仅在被询问时回答。在 Discord 中,只回答提及(mention)。在 Telegram 群组中,只回答命令或回复。
  • 限制每位用户。每位用户每隔几秒只允许一次请求。
  • 保持历史简短。只发送最近 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
是是

显示 10 个(共 215 个匹配的免费模型)。 查看所有模型.

数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。

共享代码:模型调用

两个机器人使用同一个模块。该模块为每个聊天保留简短的历史记录,为每个聊天发送一个会话 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 请求头可让一个聊天在 30 分钟内保持使用同一个模型。因此,机器人在一段对话中能保持相同的风格。如果该模型达到限制,路由器会切换到另一个模型,该模型会收到相同的历史记录。

历史记录和冷却时间保存在内存中。机器人重启后会丢失。如果机器人需要记住长对话,请将历史记录存储在 SQLite 或 Redis 等数据库中。

使用 discord.py 的 Discord 机器人

  1. 打开 Discord 开发者门户并创建一个应用。添加一个机器人并复制其 token。
  2. 在 bot 标签页中,进入 Privileged Gateway Intents。开启 Message Content。
  3. 使用 bot 范围和 Send Messages 权限,将机器人邀请到你的服务器。
  4. 在 DISCORD_TOKEN 环境变量中设置 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。复制 token。
  2. 在 TELEGRAM_TOKEN 环境变量中设置 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 用作它们的模型。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 访问网关,而网关端口对互联网保持关闭。一台小型服务器或树莓派即可同时运行两者。

故障排除

问题原因解决方法
Discord 机器人读取到空消息Message Content 权限未开启在开发者门户中开启,并在 intents.message_content 中启用
机器人回复自己的消息未检查消息作者是否为机器人当 message.author.bot 为真时直接返回
长回答时出现 Discord 错误 50035消息超过 2000 个字符拆分回答,方法同上方代码
晚上出现“All free models are busy”链中的所有密钥都已达到每日限制添加更多服务商的密钥。许多每日限制在 UTC 时间午夜重置。
回答速度慢模型速度慢,或历史记录过长使用 auto:fast,并保留 10 条或更少的消息
机器人报告 Connection refused机器人在 Docker 中运行,并使用 localhost使用 host.docker.internal 或共享的 Docker 网络
通过一个密钥使用以上每一个模型。 FreeLLMAPI 是一个开源的自托管路由器。它将所有这些免费套餐放在一个兼容 OpenAI 的端点之后,并在某个套餐被限速时自动切换。 浏览目录 或 立即开始.

常见问题

有适用于 Discord 机器人的免费 AI API 吗?

有。多家服务商提供可与 openai Python 包配合使用的免费额度。FreeLLMAPI 将它们组合在一个密钥之后,因此繁忙的机器人可以使用多个服务商的额度。

能否制作免费的 AI Telegram 机器人?

可以。机器人使用 python-telegram-bot,回答则使用兼容 OpenAI 的免费 API。本页的代码是完整的。

如何避免 AI 机器人触发速率限制?

只回答提及或命令,将每位用户限制为每隔几秒一次请求,保持历史简短,并添加更多服务商的密钥。

为什么我的 Discord 机器人读取到的消息内容为空?

Message Content 权限未开启。请在开发者门户的 bot 标签页中开启它,并在代码中设置 intents.message_content = True。

所有免费模型都达到限制时会发生什么?

FreeLLMAPI 会返回带有 Retry-After 请求头的错误 429。机器人代码会捕获该错误,并告知用户稍后再试。

相关指南

来源

全部指南 · 浏览所有免费模型