用于 Discord 或 Telegram 机器人的免费 AI API
聊天机器人每收到一条消息就会发送一次模型请求。在繁忙的服务器中,一个免费额度几分钟内就会达到限制。本指南将 Discord 机器人和 Telegram 机器人连接到 FreeLLMAPI。FreeLLMAPI 用一个兼容 OpenAI 的密钥汇集 45 个免费服务商额度,并在某个限制阻止请求时切换到下一个服务商。代码为 Python,且是完整的。
代码、模型名称和目录中的实时标签以英文显示。
先规划限制
免费额度限制每分钟和每天的请求数。一个拥有 200 名活跃用户的服务器中,机器人每天可能发送数千次请求。故障转移会把这些请求分散到你所有的密钥上,但总量仍然是各项免费限制之和。
- 仅在被询问时回答。在 Discord 中,只回答提及(mention)。在 Telegram 群组中,只回答命令或回复。
- 限制每位用户。每位用户每隔几秒只允许一次请求。
- 保持历史简短。只发送最近 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 | 是 | 是 |
显示 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 机器人
- 打开 Discord 开发者门户并创建一个应用。添加一个机器人并复制其 token。
- 在 bot 标签页中,进入 Privileged Gateway Intents。开启 Message Content。
- 使用
bot范围和 Send Messages 权限,将机器人邀请到你的服务器。 - 在
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 机器人
- 在 Telegram 中打开 @BotFather,并发送
/newbot。复制 token。 - 在
TELEGRAM_TOKEN环境变量中设置 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 用作它们的模型。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 访问网关,而网关端口对互联网保持关闭。一台小型服务器或树莓派即可同时运行两者。
故障排除
| 问题 | 原因 | 解决方法 |
|---|---|---|
| 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 网络 |
常见问题
有适用于 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。机器人代码会捕获该错误,并告知用户稍后再试。
相关指南
来源
- 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)