API هوش مصنوعی رایگان برای ربات Discord یا Telegram
یک ربات گفتگو برای هر پیام یک درخواست مدل میفرستد. در یک سرور پرترافیک، یک سطح رایگان در چند دقیقه به حد خود میرسد. این راهنما یک ربات Discord و یک ربات Telegram را به FreeLLMAPI وصل میکند. FreeLLMAPI، 45 سطح رایگان ارائهدهنده را پشت یک کلید سازگار با OpenAI گردآوری میکند و وقتی یک محدودیت درخواستی را متوقف کند، به ارائهدهنده بعدی میرود. کد Python است و کامل است.
کد، نام مدلها و برچسبهای زندهٔ کاتالوگ به زبان انگلیسی نمایش داده میشوند.
ابتدا برای محدودیتها برنامهریزی کنید
سطوح رایگان درخواستها را در دقیقه و در روز محدود میکنند. یک ربات در سروری با 200 کاربر فعال میتواند هزاران درخواست در روز بفرستد. جایگزینی این درخواستها را بین همه کلیدهای شما پخش میکند، اما جمع کل همچنان مجموع محدودیتهای رایگان است.
- فقط وقتی پرسیده شد پاسخ دهید. در Discord فقط منشنها را پاسخ دهید. در گروههای 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). محدودیتهای رایگان اغلب تغییر میکنند. کاتالوگ هر روز بررسی میشود.
کد مشترک: فراخوانی مدل
هر دو ربات از یک ماژول استفاده میکنند. این ماژول برای هر گفتگو یک تاریخچه کوتاه نگه میدارد، یک شناسه جلسه برای هر گفتگو میفرستد و محدودیتهای نرخ را مدیریت میکند. ابتدا 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 با discord.py
- پورتال توسعهدهندگان Discord را باز کنید و یک برنامه بسازید. یک Bot اضافه کنید و توکن آن را کپی کنید.
- در تب Bot به 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"])ربات Telegram با python-telegram-bot
- در 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 استفاده میکند که کاملاً async است.
عاملهای آماده برای ربات
اگر نمیخواهید ربات بنویسید، دو عامل میتوانند در 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 به دروازه میرسد و پورت دروازه برای اینترنت بسته میماند. یک سرور کوچک یا یک Raspberry Pi برای هر دو کافی است.
عیبیابی
| مشکل | علت | راهحل |
|---|---|---|
| ربات 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 مشترک استفاده کنید |
پرسشهای متداول
آیا یک API هوش مصنوعی رایگان برای ربات Discord وجود دارد؟
بله. چند ارائهدهنده سطوح رایگانی دارند که با بسته openai در Python کار میکند. FreeLLMAPI آنها را پشت یک کلید ترکیب میکند، پس یک ربات پرترافیک میتواند از محدودیتهای چند ارائهدهنده استفاده کند.
آیا میتوانم یک ربات AI رایگان Telegram بسازم؟
بله. برای ربات از python-telegram-bot و برای پاسخها از یک API رایگان سازگار با OpenAI استفاده کنید. کد این صفحه کامل است.
چگونه مانع شوم ربات AI من به محدودیتهای نرخ برسد؟
فقط به منشنها یا دستورها پاسخ دهید، هر کاربر را به یک درخواست در هر چند ثانیه محدود کنید، تاریخچه را کوتاه نگه دارید و کلیدهای ارائهدهندگان بیشتری اضافه کنید.
چرا ربات Discord من محتوای پیام خالی میگیرد؟
گزینه Message Content خاموش است. آن را در پورتال توسعهدهندگان در تب Bot روشن کنید و در کد intents.message_content = True تنظیم کنید.
وقتی همه مدلهای رایگان به حد خود برسند چه میشود؟
FreeLLMAPI خطای 429 را با هدر Retry-After برمیگرداند. کد ربات آن را میگیرد و به کاربر میگوید بعداً دوباره تلاش کند.
راهنماهای مرتبط
- API رایگان LLM در Python
- محدودیت نرخ API رایگان LLM
- آدرسهای پایه API سازگار با OpenAI رایگان
- API رایگان LLM برای عاملهای هوش مصنوعی
- API رایگان LLM بدون کارت اعتباری
منابع
- 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)