API AI gratuita per un bot Discord o Telegram
Un bot di chat invia una richiesta al modello per ogni messaggio. In un server molto attivo, un livello gratuito raggiunge il limite in pochi minuti. Questa guida collega un bot Discord e un bot Telegram a FreeLLMAPI. FreeLLMAPI raccoglie 45 livelli gratuiti di provider dietro una sola chiave compatibile con OpenAI e passa al provider successivo quando un limite blocca una richiesta. Il codice è in Python ed è completo.
Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.
Pianifichi prima i limiti
I livelli gratuiti limitano le richieste al minuto e al giorno. Un bot in un server con 200 utenti attivi può inviare migliaia di richieste al giorno. Il failover distribuisce queste richieste su tutte le Sue chiavi, ma il totale resta la somma dei limiti gratuiti.
- Risponda solo quando viene interpellato. In Discord, risponda solo alle menzioni. Nei gruppi Telegram, risponda solo ai comandi o alle risposte.
- Limiti ogni utente. Consenta una richiesta per utente ogni pochi secondi.
- Mantenga breve la cronologia. Invii gli ultimi 10 messaggi, non l'intera cronologia del canale.
- Usi un percorso veloce.
auto:fastordina i modelli per velocità. Gli utenti della chat aspettano meno. - Gestisca gli errori con garbo. Quando tutte le chiavi sono al limite, dica all'utente di riprovare più tardi.
Questi modelli gratuiti hanno oggi la velocità misurata più alta. Molti hanno limiti di richieste elevati:
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 altri | 262K | 30 richieste/min 250 richieste/giorno 70,000 token/min ~6M | Sì | Sì |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4 altri | 131K | 30 richieste/min 1,000 richieste/giorno 8,000 token/min 200,000 token/giorno ~6M | Sì | No |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2 altri | 1M | 20 richieste/min 50 richieste/giorno 50 req/day account-wide (1,000 after a $10 purchase) | Sì | No |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq +1 altri | 131K | 30 richieste/min 1,000 richieste/giorno 8,000 token/min 200,000 token/giorno ~6M | Sì | No |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 richieste/min 5,000 richieste/giorno 500,000 token/giorno 500K tokens/day · 5,000 req/day | No | No |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 richieste/min 1,000 richieste/giorno 8,000 token/min 200,000 token/giorno ~6M | Sì | No |
| Groq Compound Mini | DreamPrompting | 131K | 100 richieste/min 5,000 richieste/giorno 500,000 token/giorno 500K tokens/day · 5,000 req/day | No | No |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | Sì | Sì |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 richieste/min 5,000 richieste/giorno 500,000 token/giorno 500K tokens/day · 5,000 req/day | Sì | Sì |
Mostrati 10 di 215 modelli gratuiti corrispondenti. Vedi tutti i modelli.
Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.
Codice condiviso: la chiamata al modello
Entrambi i bot usano lo stesso modulo. Mantiene una cronologia breve per ogni chat, invia un ID di sessione per ogni chat e gestisce i limiti di frequenza. Installi prima FreeLLMAPI e copi la chiave unificata dalla pagina Keys della dashboard.
Installazione
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 [""]L'intestazione X-Session-Id mantiene una chat su un solo modello per 30 minuti. Il bot mantiene quindi lo stesso stile in una conversazione. Se quel modello raggiunge il limite, il router passa a un altro modello, che riceve la stessa cronologia.
La cronologia e i periodi di attesa sono conservati in memoria. Si perdono quando il bot si riavvia. Per un bot che deve ricordare conversazioni lunghe, salvi la cronologia in un database come SQLite o Redis.
Bot Discord con discord.py
- Apra il Discord Developer Portal e crei un'applicazione. Aggiunga un bot e ne copi il token.
- Nella scheda del bot, vada a Privileged Gateway Intents. Attivi Message Content.
- Inviti il bot nel Suo server con lo scope
bote il permesso Send Messages. - Imposti il token nella variabile d'ambiente
DISCORD_TOKENed esegua lo script.
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 con python-telegram-bot
- In Telegram, apra @BotFather e invii
/newbot. Copi il token. - Imposti il token nella variabile d'ambiente
TELEGRAM_TOKEN. - Esegua lo script. Invii un messaggio al Suo bot.
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()Lo stato di digitazione in Telegram resta per 5 secondi o meno. Per i modelli lenti, invii di nuovo l'azione di digitazione durante le richieste lunghe. Il codice usa python-telegram-bot versione 22, che è completamente asincrono.
Agenti bot già pronti
Se non vuole scrivere un bot, due agenti possono rispondere su Discord e Telegram e usano FreeLLMAPI come modello. FreeLLMAPI ha un comando di configurazione per ciascuno. Ogni comando supporta --dry-run e crea prima una copia di backup della configurazione.
| Agente | Comando di configurazione | Che cosa scrive |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Un provider freellmapi in ~/.openclaw/openclaw.json, modello predefinito freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | Un blocco di modello personalizzato in ~/.hermes/config.yaml |
Un gateway OpenClaw o Hermes in esecuzione deve essere riavviato dopo il comando di configurazione.
Esegua il bot e FreeLLMAPI sullo stesso computer o server. Il bot raggiunge allora il gateway su localhost, e la porta del gateway resta chiusa a internet. Un piccolo server o un Raspberry Pi bastano per entrambi.
Risoluzione dei problemi
| Problema | Causa | Soluzione |
|---|---|---|
| Il bot Discord legge messaggi vuoti | L'intent Message Content è disattivato | Lo attivi nel portale e in intents.message_content |
| Il bot risponde ai propri messaggi | Nessun controllo sugli autori bot | Esca quando message.author.bot è true |
| Errore Discord 50035 nelle risposte lunghe | Il messaggio supera i 2000 caratteri | Divida la risposta, come nel codice sopra |
| "All free models are busy" (messaggio in inglese: tutti i modelli gratuiti sono occupati) la sera | Tutte le chiavi della catena sono al limite giornaliero | Aggiunga chiavi di più provider. Molti limiti giornalieri si ripristinano a mezzanotte UTC. |
| Risposte lente | Un modello lento oppure una cronologia lunga | Usi auto:fast e tenga 10 messaggi o meno |
Connection refused dal bot | Il bot è in esecuzione in Docker e usa localhost | Usi host.docker.internal oppure una rete Docker condivisa |
Domande frequenti
Esiste un'API AI gratuita per un bot Discord?
Sì. Diversi provider hanno livelli gratuiti che funzionano con il pacchetto Python openai. FreeLLMAPI li combina dietro una sola chiave, quindi un bot molto attivo può usare i limiti di molti provider.
Posso creare un bot AI gratuito per Telegram?
Sì. Usi python-telegram-bot per il bot e un'API gratuita compatibile con OpenAI per le risposte. Il codice di questa pagina è completo.
Come evito che il mio bot AI raggiunga i limiti di frequenza?
Risponda solo alle menzioni o ai comandi, limiti ogni utente a una richiesta ogni pochi secondi, mantenga breve la cronologia e aggiunga chiavi di più provider.
Perché il mio bot Discord riceve contenuti dei messaggi vuoti?
L'intent Message Content è disattivato. Lo attivi nel Developer Portal nella scheda del bot, e imposti intents.message_content = True nel codice.
Che cosa succede quando tutti i modelli gratuiti sono al limite?
FreeLLMAPI restituisce l'errore 429 con un'intestazione Retry-After. Il codice del bot lo intercetta e dice all'utente di riprovare più tardi.
Guide correlate
- API LLM gratuita in Python
- Rate limit delle Free LLM API
- Base URL di API gratuite compatibili con OpenAI
- Free LLM API per agenti IA
- API LLM gratuita senza carta di credito
Fonti
- discord.py docs: quickstart (verificato il 20 November 2026)
- discord.py docs: privileged intents (verificato il 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (verificato il 20 November 2026)
- python-telegram-bot v22 docs: echobot example (verificato il 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (verificato il 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (verificato il 20 November 2026)