API de IA gratuita para un bot de Discord o Telegram
Un bot de chat envía una solicitud al modelo por cada mensaje. En un servidor concurrido, un nivel gratuito llega a su límite en minutos. Esta guía conecta un bot de Discord y un bot de Telegram con FreeLLMAPI. FreeLLMAPI reúne 45 niveles gratuitos de proveedores detrás de una sola clave compatible con OpenAI y pasa al siguiente proveedor cuando un límite detiene una solicitud. El código es Python y está completo.
El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.
Planifique primero los límites
Los niveles gratuitos limitan las solicitudes por minuto y por día. Un bot en un servidor con 200 usuarios activos puede enviar miles de solicitudes por día. La conmutación reparte estas solicitudes entre todas sus claves, pero el total sigue siendo la suma de los límites gratuitos.
- Responda solo cuando se le pida. En Discord, responda solo a las menciones. En los grupos de Telegram, responda solo a los comandos o a las respuestas.
- Limite a cada usuario. Permita una solicitud por usuario cada pocos segundos.
- Mantenga el historial corto. Envíe los últimos 10 mensajes, no todo el historial del canal.
- Use una ruta rápida.
auto:fastordena los modelos por velocidad. Los usuarios del chat esperan menos. - Falle con cortesía. Cuando todas las claves llegan a su límite, indique al usuario que lo intente más tarde.
Estos modelos gratuitos tienen hoy la velocidad medida más alta. Muchos tienen límites de solicitudes altos:
| Modelo | Gratis en | Contexto | Límites gratuitos (mejor oferta) | Herramientas | Visión |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 más | 262K | 30 solicitudes/min 250 solicitudes/día 70,000 tokens/min ~6M | Sí | Sí |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4 más | 131K | 30 solicitudes/min 1,000 solicitudes/día 8,000 tokens/min 200,000 tokens/día ~6M | Sí | No |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2 más | 1M | 20 solicitudes/min 50 solicitudes/día 50 req/day account-wide (1,000 after a $10 purchase) | Sí | No |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq +1 más | 131K | 30 solicitudes/min 1,000 solicitudes/día 8,000 tokens/min 200,000 tokens/día ~6M | Sí | No |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 solicitudes/min 5,000 solicitudes/día 500,000 tokens/día 500K tokens/day · 5,000 req/day | No | No |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 solicitudes/min 1,000 solicitudes/día 8,000 tokens/min 200,000 tokens/día ~6M | Sí | No |
| Groq Compound Mini | DreamPrompting | 131K | 100 solicitudes/min 5,000 solicitudes/día 500,000 tokens/día 500K tokens/day · 5,000 req/day | No | No |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 solicitudes/min 20 solicitudes/día 250,000 tokens/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 solicitudes/min 5,000 solicitudes/día 500,000 tokens/día 500K tokens/day · 5,000 req/day | Sí | Sí |
Se muestran 10 de 215 modelos gratuitos que coinciden. Ver todos los modelos.
Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.
Código compartido: la llamada al modelo
Ambos bots usan el mismo módulo. Mantiene un historial corto por cada chat, envía un ID de sesión por cada chat y gestiona los límites de uso. Primero instale FreeLLMAPI y copie la clave unificada desde la página Keys del panel.
Instalar
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 [""]El encabezado X-Session-Id mantiene un chat en un mismo modelo durante 30 minutos. Así el bot conserva el mismo estilo en una conversación. Si ese modelo llega a su límite, el enrutador pasa a otro modelo, que recibe el mismo historial.
El historial y los tiempos de espera se guardan en memoria. Se pierden cuando el bot se reinicia. Para un bot que debe recordar conversaciones largas, guarde el historial en una base de datos como SQLite o Redis.
Bot de Discord con discord.py
- Abra el Discord Developer Portal y cree una aplicación. Agregue un bot y copie su token.
- En la pestaña del bot, vaya a Privileged Gateway Intents. Active Message Content.
- Invite el bot a su servidor con el alcance
boty el permiso Send Messages. - Configure el token en la variable de entorno
DISCORD_TOKENy ejecute el 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 de Telegram con python-telegram-bot
- En Telegram, abra @BotFather y envíe
/newbot. Copie el token. - Configure el token en la variable de entorno
TELEGRAM_TOKEN. - Ejecute el script. Envíe un mensaje a su 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()El estado de escritura en Telegram dura 5 segundos o menos. Para modelos lentos, envíe de nuevo la acción de chat durante las solicitudes largas. El código usa python-telegram-bot versión 22, que es totalmente asíncrono.
Agentes de bot ya preparados
Si no quiere escribir un bot, dos agentes pueden responder en Discord y Telegram y usar FreeLLMAPI como su modelo. FreeLLMAPI tiene un comando de configuración para cada uno. Cada comando admite --dry-run y crea una copia de seguridad de la configuración primero.
| Agente | Comando de configuración | Qué escribe |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Un proveedor freellmapi en ~/.openclaw/openclaw.json, con el modelo predeterminado freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | Un bloque de modelo personalizado en ~/.hermes/config.yaml |
Una pasarela de OpenClaw o Hermes que esté en ejecución necesita reiniciarse después del comando de configuración.
Ejecute el bot y FreeLLMAPI en la misma computadora o servidor. Así el bot accede a la pasarela en localhost, y el puerto de la pasarela queda cerrado a internet. Un servidor pequeño o una Raspberry Pi basta para ambos.
Solución de problemas
| Problema | Causa | Solución |
|---|---|---|
| El bot de Discord lee mensajes vacíos | El intent Message Content está desactivado | Actívelo en el portal y en intents.message_content |
| El bot responde a sus propios mensajes | No hay comprobación de los autores bot | Regrese cuando message.author.bot sea verdadero |
| Error 50035 de Discord en respuestas largas | El mensaje tiene más de 2000 caracteres | Divida la respuesta, como en el código de arriba |
| "All free models are busy" por la noche | Todas las claves de la cadena llegaron a su límite diario | Agregue claves de más proveedores. Muchos límites diarios se reinician a medianoche UTC. |
| Respuestas lentas | Un modelo lento o un historial largo | Use auto:fast y mantenga 10 mensajes o menos |
Connection refused en el bot | El bot se ejecuta en Docker y usa localhost | Use host.docker.internal o una red de Docker compartida |
Preguntas frecuentes
¿Existe una API de IA gratuita para un bot de Discord?
Sí. Varios proveedores tienen niveles gratuitos que funcionan con el paquete openai de Python. FreeLLMAPI los combina detrás de una sola clave, así que un bot concurrido puede usar los límites de muchos proveedores.
¿Puedo crear un bot de IA gratuito para Telegram?
Sí. Use python-telegram-bot para el bot y una API gratuita compatible con OpenAI para las respuestas. El código de esta página está completo.
¿Cómo evito que mi bot de IA llegue a los límites de uso?
Responda solo a menciones o comandos, limite a cada usuario a una solicitud cada pocos segundos, mantenga el historial corto y agregue claves de más proveedores.
¿Por qué mi bot de Discord recibe contenido de mensaje vacío?
El intent Message Content está desactivado. Actívelo en el Developer Portal, en la pestaña del bot, y configure intents.message_content = True en el código.
¿Qué pasa cuando todos los modelos gratuitos llegan a su límite?
FreeLLMAPI devuelve el error 429 con un encabezado Retry-After. El código del bot lo captura e indica al usuario que lo intente más tarde.
Guías relacionadas
- API de LLM gratuita en Python
- Límites de uso de API LLM gratuitas
- URL base gratuitas compatibles con OpenAI
- API LLM gratuita para agentes de IA
- API de LLM gratuita sin tarjeta de crédito
Fuentes
- discord.py docs: quickstart (revisado 20 November 2026)
- discord.py docs: privileged intents (revisado 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (revisado 20 November 2026)
- python-telegram-bot v22 docs: echobot example (revisado 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (revisado 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (revisado 20 November 2026)