API AI miễn phí cho bot Discord hoặc Telegram
Bot trò chuyện gửi một yêu cầu model cho mỗi tin nhắn. Trong một máy chủ đông người, một gói miễn phí đạt giới hạn chỉ sau vài phút. Hướng dẫn này kết nối bot Discord và bot Telegram với FreeLLMAPI. FreeLLMAPI gom 45 gói miễn phí của nhà cung cấp sau một khóa tương thích OpenAI và chuyển sang nhà cung cấp tiếp theo khi một giới hạn chặn yêu cầu. Mã là Python và đầy đủ.
Mã, tên mô hình và nhãn danh mục trực tiếp được hiển thị bằng tiếng Anh.
Lên kế hoạch cho giới hạn trước
Gói miễn phí giới hạn yêu cầu mỗi phút và mỗi ngày. Một bot trong máy chủ có 200 người dùng hoạt động có thể gửi hàng nghìn yêu cầu mỗi ngày. Chuyển dự phòng chia các yêu cầu này cho mọi khóa của bạn, nhưng tổng vẫn là tổng các giới hạn miễn phí.
- Chỉ trả lời khi được gọi. Trên Discord, chỉ trả lời khi được nhắc tên. Trong nhóm Telegram, chỉ trả lời lệnh hoặc tin nhắn trả lời.
- Giới hạn từng người dùng. Cho phép một yêu cầu cho mỗi người dùng cách nhau vài giây.
- Giữ lịch sử ngắn. Gửi 10 tin nhắn gần nhất, không gửi toàn bộ lịch sử kênh.
- Dùng tuyến nhanh.
auto:fastxếp hạng model theo tốc độ. Người dùng chờ ít hơn. - Báo lỗi lịch sự. Khi mọi khóa đều đạt giới hạn, bảo người dùng thử lại sau.
Các model miễn phí này có tốc độ đo được nhanh nhất hiện nay. Nhiều model trong số đó có giới hạn yêu cầu cao:
| Mô hình | Miễn phí trên | Ngữ cảnh | Giới hạn miễn phí (ưu đãi tốt nhất) | Công cụ | Thị giác |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 nữa | 262K | 30 yêu cầu/phút 250 yêu cầu/ngày 70,000 token/phút ~6M | Có | Có |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4 nữa | 131K | 30 yêu cầu/phút 1,000 yêu cầu/ngày 8,000 token/phút 200,000 token/ngày ~6M | Có | Không |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2 nữa | 1M | 20 yêu cầu/phút 50 yêu cầu/ngày 50 req/day account-wide (1,000 after a $10 purchase) | Có | Không |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq +1 nữa | 131K | 30 yêu cầu/phút 1,000 yêu cầu/ngày 8,000 token/phút 200,000 token/ngày ~6M | Có | Không |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 yêu cầu/phút 5,000 yêu cầu/ngày 500,000 token/ngày 500K tokens/day · 5,000 req/day | Không | Không |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 yêu cầu/phút 1,000 yêu cầu/ngày 8,000 token/phút 200,000 token/ngày ~6M | Có | Không |
| Groq Compound Mini | DreamPrompting | 131K | 100 yêu cầu/phút 5,000 yêu cầu/ngày 500,000 token/ngày 500K tokens/day · 5,000 req/day | Không | Không |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | Có | Có |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 yêu cầu/phút 5,000 yêu cầu/ngày 500,000 token/ngày 500K tokens/day · 5,000 req/day | Có | Có |
Đang hiển thị 10 trong số 215 mô hình miễn phí phù hợp. Xem tất cả mô hình.
Dữ liệu trực tiếp từ danh mục FreeLLMAPI (phiên bản 2026.11.19, đã kiểm tra 2026-11-19). Giới hạn miễn phí thay đổi thường xuyên. Danh mục được kiểm tra mỗi ngày.
Mã dùng chung: lệnh gọi model
Cả hai bot dùng cùng một module. Nó giữ lịch sử ngắn cho mỗi cuộc trò chuyện, gửi một ID phiên cho mỗi cuộc trò chuyện và xử lý giới hạn tốc độ. Cài đặt FreeLLMAPI trước và sao chép khóa thống nhất từ trang Keys trên bảng điều khiển.
Cài đặt
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 [""]Tiêu đề X-Session-Id giữ một cuộc trò chuyện trên một model trong 30 phút. Bot khi đó giữ cùng văn phong trong một cuộc hội thoại. Nếu model đó đạt giới hạn, bộ định tuyến chuyển sang model khác, và model này nhận cùng lịch sử.
Lịch sử và thời gian nghỉ được lưu trong bộ nhớ. Chúng mất khi bot khởi động lại. Với bot cần nhớ các cuộc trò chuyện dài, hãy lưu lịch sử trong cơ sở dữ liệu như SQLite hoặc Redis.
Bot Discord với discord.py
- Mở Discord Developer Portal và tạo một ứng dụng. Thêm bot và sao chép token của nó.
- Ở tab bot, vào Privileged Gateway Intents. Bật Message Content.
- Mời bot vào máy chủ với phạm vi
botvà quyền Send Messages. - Đặt token trong biến môi trường
DISCORD_TOKENvà chạy tập lệnh.
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"])Bot Telegram với python-telegram-bot
- Trong Telegram, mở @BotFather và gửi
/newbot. Sao chép token. - Đặt token trong biến môi trường
TELEGRAM_TOKEN. - Chạy tập lệnh. Gửi một tin nhắn tới bot của bạn.
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()Trạng thái đang gõ trong Telegram kéo dài 5 giây hoặc ít hơn. Với model chậm, gửi lại hành động gõ trong các yêu cầu dài. Mã dùng python-telegram-bot phiên bản 22, hoàn toàn bất đồng bộ.
Agent bot có sẵn
Nếu bạn không muốn viết bot, hai agent có thể trả lời trên Discord và Telegram và dùng FreeLLMAPI làm model. FreeLLMAPI có một lệnh thiết lập cho mỗi agent. Mỗi lệnh hỗ trợ --dry-run và sao lưu cấu hình trước.
| Agent | Lệnh thiết lập | Lệnh ghi gì |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Một nhà cung cấp freellmapi trong ~/.openclaw/openclaw.json, model mặc định freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | Một khối model tùy chỉnh trong ~/.hermes/config.yaml |
Gateway OpenClaw hoặc Hermes đang chạy cần khởi động lại sau lệnh thiết lập.
Chạy bot và FreeLLMAPI trên cùng một máy tính hoặc máy chủ. Khi đó bot kết nối tới gateway qua localhost, và cổng gateway vẫn đóng với internet. Một máy chủ nhỏ hoặc Raspberry Pi là đủ cho cả hai.
Khắc phục sự cố
| Vấn đề | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Bot Discord đọc được tin nhắn trống | Quyền Message Content đang tắt | Bật nó trong portal và trong intents.message_content |
| Bot trả lời chính tin nhắn của mình | Không kiểm tra tác giả là bot | Thoát khi message.author.bot là true |
| Lỗi Discord 50035 với câu trả lời dài | Tin nhắn dài hơn 2000 ký tự | Chia nhỏ câu trả lời, như trong mã phía trên |
| "Tất cả model miễn phí đang bận" vào buổi tối | Mọi khóa trong chuỗi đều đạt giới hạn hằng ngày | Thêm khóa từ nhiều nhà cung cấp hơn. Nhiều giới hạn hằng ngày được làm mới lúc nửa đêm UTC. |
| Câu trả lời chậm | Model chậm hoặc lịch sử dài | Dùng auto:fast và giữ 10 tin nhắn trở xuống |
Connection refused từ bot | Bot chạy trong Docker và dùng localhost | Dùng host.docker.internal hoặc một mạng Docker chung |
Câu hỏi thường gặp
Có API AI miễn phí cho bot Discord không?
Có. Nhiều nhà cung cấp có gói miễn phí hoạt động với gói Python openai. FreeLLMAPI gom chúng sau một khóa, nên một bot đông người có thể dùng giới hạn của nhiều nhà cung cấp.
Tôi có thể làm bot AI Telegram miễn phí không?
Có. Dùng python-telegram-bot cho bot và một API miễn phí tương thích OpenAI cho câu trả lời. Mã trong trang này đầy đủ.
Làm sao để bot AI không chạm giới hạn tốc độ?
Chỉ trả lời khi được nhắc tên hoặc có lệnh, giới hạn mỗi người dùng một yêu cầu cách nhau vài giây, giữ lịch sử ngắn và thêm khóa từ nhiều nhà cung cấp hơn.
Tại sao bot Discord của tôi nhận nội dung tin nhắn trống?
Quyền Message Content đang tắt. Bật nó trong Developer Portal ở tab bot, và đặt intents.message_content = True trong mã.
Điều gì xảy ra khi mọi model miễn phí đều đạt giới hạn?
FreeLLMAPI trả về lỗi 429 kèm tiêu đề Retry-After. Mã của bot bắt lỗi này và bảo người dùng thử lại sau.
Hướng dẫn liên quan
- API LLM miễn phí trong Python
- Giới hạn tốc độ API LLM miễn phí
- Base URL API tương thích OpenAI miễn phí
- API LLM miễn phí cho AI agent
- API LLM miễn phí không cần thẻ tín dụng
Nguồn
- discord.py docs: quickstart (đã kiểm tra 20 November 2026)
- discord.py docs: privileged intents (đã kiểm tra 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (đã kiểm tra 20 November 2026)
- python-telegram-bot v22 docs: echobot example (đã kiểm tra 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (đã kiểm tra 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (đã kiểm tra 20 November 2026)