Inicio / Guías / API de IA gratuita para un bot de Discord o Telegram

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:fast ordena 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.
Privacidad: el bot envía los mensajes de los usuarios al proveedor que responde. Algunos niveles gratuitos pueden usar los prompts para mejorar sus modelos. Informe a sus usuarios de que un servicio de IA lee sus mensajes. Lea qué API de LLM gratuitas entrenan con sus datos y quite de su cadena los proveedores que no acepte.

Estos modelos gratuitos tienen hoy la velocidad medida más alta. Muchos tienen límites de solicitudes altos:

Modelos de chat gratuitos y rápidos
ModeloGratis enContextoLímites gratuitos (mejor oferta)HerramientasVisión
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 más262K30 solicitudes/min
250 solicitudes/día
70,000 tokens/min
~6M
SíSí
GPT-OSS 20BApi.Airforce, Cloudflare Workers AI, Groq +4 más131K30 solicitudes/min
1,000 solicitudes/día
8,000 tokens/min
200,000 tokens/día
~6M
SíNo
Nemotron 3.5 LightningElectronHub, Gizmo, Kilo Gateway +2 más1M20 solicitudes/min
50 solicitudes/día
50 req/day account-wide (1,000 after a $10 purchase)
SíNo
GPT-OSS 120BCloudflare Workers AI, ElectronHub, Groq +1 más131K30 solicitudes/min
1,000 solicitudes/día
8,000 tokens/min
200,000 tokens/día
~6M
SíNo
GPT-OSS 20B (via Groq)DreamPrompting131K100 solicitudes/min
5,000 solicitudes/día
500,000 tokens/día
500K tokens/day · 5,000 req/day
NoNo
GPT-OSS Safeguard 20BGroq131K30 solicitudes/min
1,000 solicitudes/día
8,000 tokens/min
200,000 tokens/día
~6M
SíNo
Groq Compound MiniDreamPrompting131K100 solicitudes/min
5,000 solicitudes/día
500,000 tokens/día
500K tokens/day · 5,000 req/day
NoNo
Gemini 3.5 Flash LiteElectronHub, Google AI Studio1M15 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Step 3.7 FlashElectronHub256K$0.25/week shared recurring creditSíSí
Gemini 3.1 Flash-LiteDreamPrompting, Google AI Studio1M100 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

  1. Abra el Discord Developer Portal y cree una aplicación. Agregue un bot y copie su token.
  2. En la pestaña del bot, vaya a Privileged Gateway Intents. Active Message Content.
  3. Invite el bot a su servidor con el alcance bot y el permiso Send Messages.
  4. Configure el token en la variable de entorno DISCORD_TOKEN y 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

  1. En Telegram, abra @BotFather y envíe /newbot. Copie el token.
  2. Configure el token en la variable de entorno TELEGRAM_TOKEN.
  3. 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.

AgenteComando de configuraciónQué escribe
OpenClawnpx 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 Agentnpx 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

ProblemaCausaSolución
El bot de Discord lee mensajes vacíosEl intent Message Content está desactivadoActívelo en el portal y en intents.message_content
El bot responde a sus propios mensajesNo hay comprobación de los autores botRegrese cuando message.author.bot sea verdadero
Error 50035 de Discord en respuestas largasEl mensaje tiene más de 2000 caracteresDivida la respuesta, como en el código de arriba
"All free models are busy" por la nocheTodas las claves de la cadena llegaron a su límite diarioAgregue claves de más proveedores. Muchos límites diarios se reinician a medianoche UTC.
Respuestas lentasUn modelo lento o un historial largoUse auto:fast y mantenga 10 mensajes o menos
Connection refused en el botEl bot se ejecuta en Docker y usa localhostUse host.docker.internal o una red de Docker compartida
Use cada uno de estos modelos con una sola clave. FreeLLMAPI es un enrutador de código abierto y autoalojado. Reúne todos estos niveles gratuitos detrás de un único endpoint compatible con OpenAI y cambia de proveedor cuando uno alcanza su límite. Explore el catálogo o ir en vivo.

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

Fuentes

Todas las guías · Ver todos los modelos gratuitos