خانه / راهنماها / API هوش مصنوعی رایگان برای ربات Discord یا Telegram

API هوش مصنوعی رایگان برای ربات Discord یا Telegram

یک ربات گفتگو برای هر پیام یک درخواست مدل می‌فرستد. در یک سرور پرترافیک، یک سطح رایگان در چند دقیقه به حد خود می‌رسد. این راهنما یک ربات Discord و یک ربات Telegram را به FreeLLMAPI وصل می‌کند. FreeLLMAPI، 45 سطح رایگان ارائه‌دهنده را پشت یک کلید سازگار با OpenAI گردآوری می‌کند و وقتی یک محدودیت درخواستی را متوقف کند، به ارائه‌دهنده بعدی می‌رود. کد Python است و کامل است.

کد، نام مدل‌ها و برچسب‌های زندهٔ کاتالوگ به زبان انگلیسی نمایش داده می‌شوند.

ابتدا برای محدودیت‌ها برنامه‌ریزی کنید

سطوح رایگان درخواست‌ها را در دقیقه و در روز محدود می‌کنند. یک ربات در سروری با 200 کاربر فعال می‌تواند هزاران درخواست در روز بفرستد. جایگزینی این درخواست‌ها را بین همه کلیدهای شما پخش می‌کند، اما جمع کل همچنان مجموع محدودیت‌های رایگان است.

  • فقط وقتی پرسیده شد پاسخ دهید. در Discord فقط منشن‌ها را پاسخ دهید. در گروه‌های Telegram فقط دستورها یا پاسخ‌ها را پاسخ دهید.
  • هر کاربر را محدود کنید. به هر کاربر هر چند ثانیه یک درخواست بدهید.
  • تاریخچه را کوتاه نگه دارید. 10 پیام آخر را بفرستید، نه کل تاریخچه کانال را.
  • از یک مسیر سریع استفاده کنید. auto:fast مدل‌ها را بر اساس سرعت رتبه‌بندی می‌کند. کاربران گفتگو کمتر منتظر می‌مانند.
  • خطا را مؤدبانه نشان دهید. وقتی همه کلیدها به حد خود رسیده باشند، به کاربر بگویید بعداً دوباره تلاش کند.
حریم خصوصی: ربات پیام‌های کاربر را به ارائه‌دهنده‌ای می‌فرستد که پاسخ می‌دهد. برخی سطوح رایگان ممکن است از پرامپت‌ها برای بهبود مدل‌هایشان استفاده کنند. به کاربران خود بگویید که یک سرویس هوش مصنوعی پیام‌هایشان را می‌خواند. کدام API های رایگان LLM روی داده شما آموزش می‌دهند را بخوانید و ارائه‌دهندگانی را که قبول ندارید از زنجیره خود حذف کنید.

این مدل‌های رایگان امروز بیشترین سرعت اندازه‌گیری‌شده را دارند. بسیاری از آن‌ها محدودیت درخواست بالایی دارند:

مدل‌های گفتگوی رایگان سریع
مدلرایگان درمتن ورودیمحدودیت‌های رایگان (بهترین پیشنهاد)ابزارهابینایی
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). محدودیت‌های رایگان اغلب تغییر می‌کنند. کاتالوگ هر روز بررسی می‌شود.

کد مشترک: فراخوانی مدل

هر دو ربات از یک ماژول استفاده می‌کنند. این ماژول برای هر گفتگو یک تاریخچه کوتاه نگه می‌دارد، یک شناسه جلسه برای هر گفتگو می‌فرستد و محدودیت‌های نرخ را مدیریت می‌کند. ابتدا 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

  1. پورتال توسعه‌دهندگان Discord را باز کنید و یک برنامه بسازید. یک Bot اضافه کنید و توکن آن را کپی کنید.
  2. در تب Bot به 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"])

ربات Telegram با python-telegram-bot

  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 استفاده می‌کند که کاملاً async است.

عامل‌های آماده برای ربات

اگر نمی‌خواهید ربات بنویسید، دو عامل می‌توانند در 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 به دروازه می‌رسد و پورت دروازه برای اینترنت بسته می‌ماند. یک سرور کوچک یا یک 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 مشترک استفاده کنید
هر یک از این‌ها را با یک کلید استفاده کنید. FreeLLMAPI یک روتر متن‌باز و میزبانی‌شده روی سرور خودتان است. این روتر همه این سطوح رایگان را پشت یک نقطه پایانی سازگار با OpenAI قرار می‌دهد و وقتی یک سرویس به محدودیت نرخ برسد، به سرویس بعدی منتقل می‌شود. مرور کاتالوگ یا اجرای زنده.

پرسش‌های متداول

آیا یک 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 برمی‌گرداند. کد ربات آن را می‌گیرد و به کاربر می‌گوید بعداً دوباره تلاش کند.

راهنماهای مرتبط

منابع

همه راهنماها · مرور همه مدل‌های رایگان