freellmapi LLM gratuitos API unificada: el repositorio tashfeenahmed/freellmapi es un router autoalojado que expone un único punto de acceso compatible con OpenAI (/v1) delante de las ofertas gratuitas de decenas de proveedores de modelos. Mostraba unas 39 200 estrellas y 5 300 forks a mediados de octubre de 2026, con licencia MIT.
La idea resulta atractiva: un solo cliente, varias cuotas gratuitas sumadas y un cambio automático de proveedor ante un error 429. Pero para un equipo de operaciones plantea también tres preguntas serias: las condiciones de uso de cada proveedor, la privacidad de lo que se envía y la fiabilidad de un servicio sin garantías. Este artículo las repasa a partir del README y de la documentación del proyecto.
La información procede del README y de la documentación del repositorio. span.observer no ha instalado ni probado freellmapi: las capturas de abajo son imágenes publicadas en el repositorio por el propio proyecto. Las cifras promocionales del README (volumen de tokens, número de proveedores) se presentan como declaraciones del proyecto, no verificadas.
freellmapi LLM gratuitos API unificada: qué dice el repositorio
- Autor y licencia: repositorio del usuario de GitHub
tashfeenahmed, licencia MIT (copyright 2026 en el archivo LICENSE). - Funcionamiento: añades tus propias claves de API gratuitas; el router elige un modelo para cada petición, pasa al siguiente ante un error 429 o 5xx y sigue el uso por clave (peticiones y tokens por minuto y por día) para mantenerse por debajo de los límites.
- Cifras declaradas por el proyecto: «34 proveedores gratuitos» y «635 puntos de acceso»; la página de GitHub menciona además «7,4 mil millones de tokens al mes». Son totales sumados de cuotas gratuitas listadas, no una capacidad garantizada ni medida.
- Superficies de API (según el README): chat, respuestas, embeddings, imágenes, audio, además de la API Messages de Anthropic, lo que permite conectar Claude Code al router.
- Marco de uso: la descripción del repositorio termina con «Personal experimentation only» y el README precisa: «personal experimentation and learning, not production».

La página Models del dashboard, publicada en el repositorio, muestra el presupuesto mensual de tokens repartido por modelo, la estrategia de enrutamiento (Manual, Balanced, Smartest, Fastest, Most reliable, Custom) y una clasificación con puntuaciones de fiabilidad, velocidad e inteligencia actualizadas según el tráfico.
Instalar freellmapi según el README
Paso 1 — El script de instalación (requiere Docker)
curl -fsSL https://freellmapi.co/install.sh | bash
Según el README, el script crea ~/freellmapi, genera una clave de cifrado, descarga la imagen y arranca el contenedor. El README recuerda que puedes leer el script antes de ejecutarlo: hazlo, sobre todo porque el comando descarga un script remoto. Si vuelves a lanzar el script, se conservan el archivo .env y la clave.
Paso 2 — Añadir las claves y obtener la clave unificada
Abre http://localhost:3001, añade las claves de tus proveedores en la página Keys, ordena la cadena de respaldo y copia la clave unificada que aparece en la parte superior de esa página: es la que usarán tus aplicaciones.
Paso 3 — Apuntar un cliente compatible con OpenAI
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:3001/v1",
api_key="freellmapi-your-unified-key",
)
resp = client.chat.completions.create(
model="auto",
messages=[{"role": "user", "content": "Summarise the fall of Rome in one sentence."}],
)
print(resp.choices[0].message.content)
Este ejemplo reproduce el del README (ligeramente acortado). model="auto" deja que el router elija. Según la documentación de la API, cada respuesta lleva una cabecera X-Routed-Via: <plataforma>/<modelo> que indica qué proveedor respondió realmente: para leerla, prueba con curl -i.
Variantes
El README propone también una aplicación de escritorio (.dmg para macOS, instalador .exe para Windows, en las Releases), un despliegue con Docker Compose y un modo de desarrollo. Se describe una configuración automática para numerosos agentes, por ejemplo npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>.
Bajo el capó: enrutamiento, cuotas, logs
El proyecto describe un router que selecciona el modelo prioritario con una clave sana y por debajo de todos sus límites, descifra la clave en memoria, llama al proveedor y, ante un 429 o 5xx, pone la clave en pausa antes de pasar al modelo siguiente.

El esquema ilustra este flujo: un primer proveedor devuelve 429 y se descarta, un segundo responde. El README precisa que las claves de los proveedores se cifran con AES-256-GCM en SQLite y se descifran en memoria en cada petición.
Monitorizar un router de LLM gratuitos
La documentación de arquitectura del proyecto describe una parte de observabilidad: visor de logs del servidor en el dashboard, logs conservados en memoria (1 000 entradas) y en base de datos para avisos y errores, y una página Analytics (volumen de peticiones, tasa de éxito, tokens, latencias p50 y p95, tiempo hasta el primer token) en ventanas de 24 horas a 90 días. No he encontrado ninguna mención de OpenTelemetry en el README ni en la documentación.

- Logs: con Docker,
docker compose logs -f freellmapi(FAQ del README); para la aplicación de escritorio, el archivofreeapi.logen la carpeta de datos. - Lado cliente: si quieres trazas en tu propio backend, instrumenta la aplicación que llama al router, por ejemplo con los métodos de la observabilidad de LLM con OpenLLMetry y Langfuse, y registra la cabecera
X-Routed-Viacomo atributo. - Costes: el uso es gratuito mientras las cuotas aguanten, pero el tiempo perdido en errores y en cambios de proveedor tiene un coste. Consulta el seguimiento del coste de un agente de IA.
Condiciones de uso, cuotas y privacidad
Este es el punto más importante. El README recuerda que tu relación con cada proveedor sigue regida por las condiciones que aceptaste al crear la cuenta, y que esas condiciones se aplican también cuando el tráfico pasa por este proyecto: eres responsable de cumplirlas.
- Análisis del proyecto, no el nuestro. La documentación incluye una tabla de revisión de las condiciones de uso, fechada en mayo de 2026, proveedor por proveedor (por ejemplo «precaución» para Google Gemini y NVIDIA NIM, «evitar» para Cohere). Es la opinión del proyecto, sin valor jurídico, y tiene varios meses. Vuelve a leer las condiciones vigentes de cada proveedor antes de cualquier uso.
- Cuotas. Las ofertas gratuitas pueden recortarse o retirarse sin previo aviso, advierte la documentación del proyecto; los mejores modelos tienen los límites diarios más bajos y la calidad efectiva baja al final del día, hasta el reinicio a medianoche UTC. Los importes que cita el proyecto son los que el proyecto lista, no compromisos de los proveedores.
- Privacidad. Cada petición sale de tu máquina hacia el proveedor que elige el router, y esa elección cambia según las cuotas y los errores. Por tanto, no controlas qué proveedor ve qué prompt. No envíes datos personales ni código confidencial, y comprueba, en cada oferta gratuita, si los intercambios pueden usarse para mejorar los modelos.
- Llamadas salientes del router. El README indica que el router descarga dos veces al día un catálogo firmado desde freellmapi.co, y que ese servidor de catálogo no ve tus prompts ni tus claves, según el proyecto. Las instalaciones gratuitas reciben una instantánea mensual, con un desfase de 30 días; el proyecto vende además una oferta de pago para el catálogo en directo.
Cómo comprobar que funciona
- Una petición
curl -ia/v1/chat/completionscon la clave unificada devuelve una respuesta y una cabeceraX-Routed-Via. - La página Keys indica el estado de cada clave (sana, con error) y la fecha de la última comprobación.
- La página Analytics registra la petición de prueba; los logs muestran el cambio de proveedor cuando desactivas una clave.
Límites y puntos abiertos
- No es para producción. El propio proyecto lo dice: sin SLA, latencia variable, calidad que baja a lo largo del día. Para algo real, pasa a una API de pago con contrato; consulta elegir un LLM según criterios de operación.
- Uso local y de un solo usuario. La documentación del proyecto indica que no hay autenticación multiusuario: no lo expongas en Internet.
- Zona gris contractual. Agregar ofertas gratuitas detrás de un proxy puede infringir las condiciones de algunos proveedores, incluso para un uso personal.
- Proyecto muy popular y reciente. Muchas estrellas no equivalen a una auditoría: revisa el código antes de confiarle claves de API.
- Cifras. Estrellas y forks tomados a mediados de octubre de 2026; los totales de tokens son los del README.
Buenas prácticas
- Resérvalo para la experimentación, con datos públicos o ficticios.
- Lee el script de instalación antes de ejecutarlo y mantén el router en
localhosto en una red privada. - Crea claves dedicadas en cada proveedor, revocables y sin derechos de facturación.
- Desactiva en la página Keys los proveedores cuyas condiciones no encajen con tu uso.
- Instrumenta el cliente y mantén una solución de respaldo de pago para todo lo que importe.
- Para una inferencia que controles de extremo a extremo, consulta Ollama en local o vLLM en producción.
Preguntas frecuentes
¿Es freellmapi realmente gratuito?
El código tiene licencia MIT y usas tus propias claves gratuitas. Existe una oferta de pago para el catálogo en directo, y los proveedores pueden modificar o retirar sus ofertas gratuitas en cualquier momento.
¿Puedo usarlo en producción?
El proyecto lo desaconseja explícitamente: «personal experimentation and learning, not production». Usa una API de pago con contrato para un servicio real.
¿Son confidenciales mis prompts?
Llegan al proveedor elegido por el router, que puede cambiar de una petición a otra. Según el proyecto, el servidor de catálogo no ve los prompts, pero eso no dice nada de la política de cada proveedor: léelas.
Conclusión
freellmapi es una idea práctica para prototipar sin factura, con un dashboard y unos logs cuidados. Sigue siendo una herramienta de experimentación: condiciones de uso que comprobar proveedor por proveedor, cuotas cambiantes y privacidad no controlada. Mantenlo lejos de los datos sensibles y de la producción.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a los proyectos citados. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos y las opciones en la documentación oficial (github.com/tashfeenahmed/freellmapi). Este artículo no constituye asesoramiento jurídico.