API AI gratuit pentru un bot Discord sau Telegram
Un bot de chat trimite o cerere de model pentru fiecare mesaj. Într-un server aglomerat, un nivel gratuit ajunge la limită în câteva minute. Acest ghid conectează un bot Discord și un bot Telegram la FreeLLMAPI. FreeLLMAPI grupează 45 niveluri gratuite de la furnizori în spatele unei singure chei compatibile cu OpenAI și trece la următorul furnizor când o limită oprește o cerere. Codul este în Python și este complet.
Codul, numele modelelor și etichetele live din catalog sunt afișate în engleză.
Planificați mai întâi limitele
Nivelurile gratuite limitează cererile pe minut și pe zi. Un bot dintr-un server cu 200 de utilizatori activi poate trimite mii de cereri pe zi. Failover-ul împarte aceste cereri între toate cheile dvs., dar totalul este în continuare suma limitelor gratuite.
- Răspundeți doar când vi se cere. În Discord, răspundeți doar la mențiuni. În grupurile Telegram, răspundeți doar la comenzi sau la răspunsuri.
- Limitați fiecare utilizator. Permiteți o cerere per utilizator la câteva secunde.
- Păstrați istoricul scurt. Trimiteți ultimele 10 mesaje, nu tot istoricul canalului.
- Folosiți o rută rapidă.
auto:fastordonează modelele după viteză. Utilizatorii de chat așteaptă mai puțin. - Eșuați politicos. Când fiecare cheie a atins limita, spuneți utilizatorului să încerce din nou mai târziu.
Aceste modele gratuite au cea mai rapidă viteză măsurată astăzi. Multe dintre ele au limite mari de cereri:
| Model | Gratuit pe | Context | Limite gratuite (cea mai bună ofertă) | Instrumente | Viziune |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 în plus | 262K | 30 cereri/min 250 cereri/zi 70,000 tokeni/min ~6M | Da | Da |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4 în plus | 131K | 30 cereri/min 1,000 cereri/zi 8,000 tokeni/min 200,000 tokeni/zi ~6M | Da | Nu |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2 în plus | 1M | 20 cereri/min 50 cereri/zi 50 req/day account-wide (1,000 after a $10 purchase) | Da | Nu |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq +1 în plus | 131K | 30 cereri/min 1,000 cereri/zi 8,000 tokeni/min 200,000 tokeni/zi ~6M | Da | Nu |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 cereri/min 5,000 cereri/zi 500,000 tokeni/zi 500K tokens/day · 5,000 req/day | Nu | Nu |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 cereri/min 1,000 cereri/zi 8,000 tokeni/min 200,000 tokeni/zi ~6M | Da | Nu |
| Groq Compound Mini | DreamPrompting | 131K | 100 cereri/min 5,000 cereri/zi 500,000 tokeni/zi 500K tokens/day · 5,000 req/day | Nu | Nu |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | Da | Da |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 cereri/min 5,000 cereri/zi 500,000 tokeni/zi 500K tokens/day · 5,000 req/day | Da | Da |
Se afișează 10 din 215 modele gratuite care se potrivesc. Vezi toate modelele.
Date live din catalogul FreeLLMAPI (versiunea 2026.11.19, verificat 2026-11-19). Limitele gratuite se schimbă des. Catalogul este verificat în fiecare zi.
Cod comun: apelul modelului
Ambii boți folosesc același modul. Acesta păstrează un istoric scurt pentru fiecare chat, trimite un ID de sesiune pentru fiecare chat și gestionează limitele de cereri. Instalați mai întâi FreeLLMAPI și copiați cheia unificată din pagina Keys a panoului de control.
Instalare
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 [""]Antetul X-Session-Id păstrează un chat pe același model timp de 30 de minute. Botul menține apoi același stil într-o conversație. Dacă acel model ajunge la limită, routerul trece la alt model, care primește același istoric.
Istoricul și perioadele de răcire sunt păstrate în memorie. Se pierd când botul repornește. Pentru un bot care trebuie să își amintească conversații lungi, salvați istoricul într-o bază de date, precum SQLite sau Redis.
Bot Discord cu discord.py
- Deschideți Discord Developer Portal și creați o aplicație. Adăugați un bot și copiați tokenul său.
- În fila bot, mergeți la Privileged Gateway Intents. Activați Message Content.
- Invitați botul pe serverul dvs. cu domeniul
botși permisiunea Send Messages. - Setați tokenul în variabila de mediu
DISCORD_TOKENși rulați scriptul.
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 cu python-telegram-bot
- În Telegram, deschideți @BotFather și trimiteți
/newbot. Copiați tokenul. - Setați tokenul în variabila de mediu
TELEGRAM_TOKEN. - Rulați scriptul. Trimiteți un mesaj botului dvs.
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()Starea de scriere din Telegram rămâne 5 secunde sau mai puțin. Pentru modele lente, trimiteți din nou acțiunea de chat în timpul cererilor lungi. Codul folosește python-telegram-bot versiunea 22, care este complet async.
Agenți-boți gata făcuți
Dacă nu doriți să scrieți un bot, doi agenți pot răspunde pe Discord și Telegram și pot folosi FreeLLMAPI ca model. FreeLLMAPI are o comandă de configurare pentru fiecare. Fiecare comandă acceptă --dry-run și face mai întâi o copie de rezervă a configurației.
| Agent | Comandă de configurare | Ce scrie |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Un furnizor freellmapi în ~/.openclaw/openclaw.json, model implicit freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | Un bloc de model personalizat în ~/.hermes/config.yaml |
Un gateway OpenClaw sau Hermes care rulează are nevoie de o repornire după comanda de configurare.
Rulați botul și FreeLLMAPI pe același calculator sau server. Botul ajunge atunci la gateway pe localhost, iar portul gateway-ului rămâne închis pentru internet. Un server mic sau un Raspberry Pi este suficient pentru amândouă.
Depanare
| Problemă | Cauză | Remediere |
|---|---|---|
| Botul Discord citește mesaje goale | Intenția Message Content este dezactivată | Activați-o în portal și în intents.message_content |
| Botul răspunde propriilor mesaje | Nu există nicio verificare pentru autorii de boți | Reveniți când message.author.bot este true |
| Eroarea Discord 50035 la răspunsuri lungi | Mesajul are mai mult de 2000 de caractere | Împărțiți răspunsul, ca în codul de mai sus |
| „Toate modelele gratuite sunt ocupate” seara | Toate cheile din lanț au atins limita zilnică | Adăugați chei de la mai mulți furnizori. Multe limite zilnice se resetează la miezul nopții UTC. |
| Răspunsuri lente | Un model lent sau un istoric lung | Folosiți auto:fast și păstrați 10 mesaje sau mai puțin |
Connection refused de la bot | Botul rulează în Docker și folosește localhost | Folosiți host.docker.internal sau o rețea Docker comună |
Întrebări frecvente
Există un API AI gratuit pentru un bot Discord?
Da. Mai mulți furnizori au niveluri gratuite care funcționează cu pachetul Python openai. FreeLLMAPI le combină într-o singură cheie, deci un bot aglomerat poate folosi limitele mai multor furnizori.
Pot crea un bot AI gratuit pentru Telegram?
Da. Folosiți python-telegram-bot pentru bot și un API gratuit compatibil OpenAI pentru răspunsuri. Codul din această pagină este complet.
Cum opresc botul AI să atingă limitele de cereri?
Răspundeți doar la mențiuni sau comenzi, limitați fiecare utilizator la o cerere la câteva secunde, păstrați istoricul scurt și adăugați chei de la mai mulți furnizori.
De ce primește botul meu Discord conținut de mesaj gol?
Intenția Message Content este dezactivată. Activați-o în Developer Portal, în fila bot, și setați intents.message_content = True în cod.
Ce se întâmplă când toate modelele gratuite ating limita?
FreeLLMAPI returnează eroarea 429 cu un antet Retry-After. Codul botului o prinde și îi spune utilizatorului să încerce din nou mai târziu.
Ghiduri înrudite
- API LLM gratuit în Python
- Limite de rată pentru Free LLM API
- URL-uri de bază gratuite compatibile OpenAI
- Free LLM API pentru agenți AI
- API LLM gratuit fără card de credit
Surse
- discord.py docs: quickstart (verificat 20 November 2026)
- discord.py docs: privileged intents (verificat 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (verificat 20 November 2026)
- python-telegram-bot v22 docs: echobot example (verificat 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (verificat 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (verificat 20 November 2026)