Home / Guide / API AI gratuita per un bot Discord o Telegram

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:fast ordina 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.
Privacy: il bot invia i messaggi degli utenti al provider che risponde. Alcuni livelli gratuiti possono usare i prompt per migliorare i propri modelli. Informi i Suoi utenti che un servizio AI legge i loro messaggi. Legga quali API LLM gratuite si addestrano sui Suoi dati e rimuova dalla catena i provider che non accetta.

Questi modelli gratuiti hanno oggi la velocità misurata più alta. Molti hanno limiti di richieste elevati:

Modelli di chat gratuiti veloci
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 altri262K30 richieste/min
250 richieste/giorno
70,000 token/min
~6M
SìSì
GPT-OSS 20BApi.Airforce, Cloudflare Workers AI, Groq +4 altri131K30 richieste/min
1,000 richieste/giorno
8,000 token/min
200,000 token/giorno
~6M
SìNo
Nemotron 3.5 LightningElectronHub, Gizmo, Kilo Gateway +2 altri1M20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìNo
GPT-OSS 120BCloudflare Workers AI, ElectronHub, Groq +1 altri131K30 richieste/min
1,000 richieste/giorno
8,000 token/min
200,000 token/giorno
~6M
SìNo
GPT-OSS 20B (via Groq)DreamPrompting131K100 richieste/min
5,000 richieste/giorno
500,000 token/giorno
500K tokens/day · 5,000 req/day
NoNo
GPT-OSS Safeguard 20BGroq131K30 richieste/min
1,000 richieste/giorno
8,000 token/min
200,000 token/giorno
~6M
SìNo
Groq Compound MiniDreamPrompting131K100 richieste/min
5,000 richieste/giorno
500,000 token/giorno
500K tokens/day · 5,000 req/day
NoNo
Gemini 3.5 Flash LiteElectronHub, Google AI Studio1M15 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Step 3.7 FlashElectronHub256K$0.25/week shared recurring creditSìSì
Gemini 3.1 Flash-LiteDreamPrompting, Google AI Studio1M100 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

  1. Apra il Discord Developer Portal e crei un'applicazione. Aggiunga un bot e ne copi il token.
  2. Nella scheda del bot, vada a Privileged Gateway Intents. Attivi Message Content.
  3. Inviti il bot nel Suo server con lo scope bot e il permesso Send Messages.
  4. Imposti il token nella variabile d'ambiente DISCORD_TOKEN ed 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

  1. In Telegram, apra @BotFather e invii /newbot. Copi il token.
  2. Imposti il token nella variabile d'ambiente TELEGRAM_TOKEN.
  3. 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.

AgenteComando di configurazioneChe cosa scrive
OpenClawnpx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key>Un provider freellmapi in ~/.openclaw/openclaw.json, modello predefinito freellmapi/auto
Hermes Agentnpx 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

ProblemaCausaSoluzione
Il bot Discord legge messaggi vuotiL'intent Message Content è disattivatoLo attivi nel portale e in intents.message_content
Il bot risponde ai propri messaggiNessun controllo sugli autori botEsca quando message.author.bot è true
Errore Discord 50035 nelle risposte lungheIl messaggio supera i 2000 caratteriDivida la risposta, come nel codice sopra
"All free models are busy" (messaggio in inglese: tutti i modelli gratuiti sono occupati) la seraTutte le chiavi della catena sono al limite giornalieroAggiunga chiavi di più provider. Molti limiti giornalieri si ripristinano a mezzanotte UTC.
Risposte lenteUn modello lento oppure una cronologia lungaUsi auto:fast e tenga 10 messaggi o meno
Connection refused dal botIl bot è in esecuzione in Docker e usa localhostUsi host.docker.internal oppure una rete Docker condivisa
Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

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

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti