GuíaAvanzado
Gateways de IA y Ruteo de Modelos
Cuando una empresa tiene varias apps, varios equipos y más de un proveedor de modelos, llamar directo a cada API deja de alcanzar: las llaves se copian en todos lados, nadie sabe qué equipo gasta qué, cada app reinventa sus reintentos y una caída del proveedor es una caída del producto. Un AI gateway es la capa que pone orden en medio: una sola API para todas las apps y una sola puerta hacia los proveedores, donde viven el ruteo, los fallbacks, los presupuestos, los límites, el caché, los guardrails y la observabilidad. Lo aprendes construyendo el gateway de **Ondaria**, una plataforma ficticia de cobros para pymes con tres equipos que usan LLMs: un chat de soporte en vivo, un lote nocturno de resúmenes y un equipo que prueba modelos nuevos. Primero mides cómo se comporta Ondaria sin gateway durante una caída simulada. Después construyes **minigate**, un gateway propio escrito solo con la biblioteca estándar de Python, módulo por módulo: un proxy que traduce entre la API de OpenAI y la de Anthropic, ruteo por costo con piso de calidad medido por evals, por calidad y por latencia, reintentos con backoff y presupuesto de reintentos, fallbacks y circuit breakers, claves virtuales con presupuesto por equipo, rate limits por tokens por minuto, caché con espacio de nombres por equipo, guardrails de entrada y salida, y un registro con métricas en formato Prometheus. En cada módulo montas lo mismo con **LiteLLM proxy** (v1.106.0), para saber qué hace una herramienta open source por dentro y decidir con criterio entre construir y adoptar. Todo corre en tu laptop con Docker y dos simuladores que imitan las APIs de Anthropic y de OpenAI, con sus formatos, sus errores y sus streams. No necesitas cuentas ni llaves de API. Un modo `--live` opcional apunta minigate a los proveedores reales con tus llaves. Precios y modelos con fecha de corte de octubre de 2026.
- 64
- lecciones
- 8
- módulos
- Inglés · Español
- disponible en
- Gratis
- acceso
Resultados
Lo que vas a poder hacer
- Explicar qué hace un AI gateway (plano de datos y plano de control), qué cuesta y cuándo no hace falta uno
- Construir un proxy que recibe Chat Completions y lo traduce a Anthropic Messages, con errores normalizados y streaming
- Rutear peticiones por costo con un piso de calidad medido por evals, por calidad y por latencia observada
- Reintentar con backoff exponencial, jitter y Retry-After bajo un presupuesto de reintentos, caer a otro proveedor y enfriar despliegues que fallan
- Emitir claves virtuales por equipo y app, llevar un libro de gasto con el costo real y hacer cumplir presupuestos
- Limitar por tokens por minuto con un token bucket que reserva y concilia, y devolver errores 429 que un cliente puede usar
- Agregar un caché exacto con espacio de nombres por equipo y guardrails de entrada y salida que funcionan también en streams
- Observar el gateway con una línea de log por petición, métricas Prometheus y trazas W3C, y operarlo en producción
- Montar lo mismo con LiteLLM proxy y decidir entre construir, adoptar o contratar un servicio administrado
Antes de empezar
Qué necesitas traer
Es para ti si...
- Ingenieros de plataforma y backend que sostienen varias apps con LLMs en la misma empresa
- AI engineers que ya llaman a un modelo desde código y ahora tienen que responder por costo, disponibilidad y control
- Líderes técnicos que tienen que decidir si construir un gateway, adoptar uno open source o contratar uno administrado
Requisitos y materiales
- Haber llamado a la API de un LLM desde código: tokens, system prompt, `max_tokens`, el objeto `usage` (lo cubre la guía Construir con LLMs desde Código)
- Python intermedio: funciones, clases, `dataclass`, diccionarios, `json`
- HTTP básico (métodos, headers, códigos de estado) y `curl`
- Docker y Docker Compose a nivel de `up`, `logs`, `restart` y `down`
- Python 3.10 o superior para los scripts de cliente. No hace falta ninguna llave de API
Contenido
El temario, módulo por módulo
Abre cualquiera para ver sus lecciones.
- 1. Introducción: Ondaria llama directo a dos proveedores
- 2. El costo de llamar directo a cada proveedor
- 3. Plano de datos y plano de control
- 4. Las formas de un gateway
- 5. Los simuladores de proveedor
- 6. Cómo fallan los proveedores
- 7. El gateway como dependencia
- 8. Proyecto: la línea base de Ondaria sin gateway
- 1. Introducción: un solo idioma para todas las apps
- 2. Una API para todos los proveedores
- 3. Traducir a Anthropic Messages
- 4. El servidor del gateway
- 5. Errores normalizados
- 6. Streaming a través del gateway
- 7. LiteLLM proxy: el mismo trabajo con una herramienta open source
- 8. Proyecto: minigate v1 con el SDK oficial
- 1. Introducción: el lote que dejó sin servicio a soporte
- 2. Por qué peticiones por minuto no alcanza
- 3. Token bucket y ventana deslizante
- 4. Reservar y después conciliar
- 5. Límites por clave, equipo y despliegue
- 6. Un buen 429 y los límites distribuidos
- 7. Rate limits en LiteLLM
- 8. Proyecto: el lote ya no tumba a soporte
- 1. Introducción: políticas que no dependen de cada app
- 2. Qué cachear en el gateway
- 3. Llaves de caché y espacios de nombres
- 4. TTL, invalidación y cache-control
- 5. Guardrails que pertenecen al gateway
- 6. Enmascarar y bloquear en la práctica
- 7. Caching y guardrails en LiteLLM
- 8. Proyecto: el caché y la política de Ondaria
Dudas frecuentes
Lo que suele preguntarse
Sin límite. Es una guía gratuita: entras cuando quieras, las veces que quieras.
No. Los módulos están ordenados de menos a más, pero puedes saltar al que necesites. Tu progreso se guarda por lección.
Lo que haga falta está en «Qué necesitas traer», arriba. Si no aparece nada ahí, puedes empezar desde cero.
En el grupo de WhatsApp, y cada quince días hay un live con un instructor donde se resuelven dudas en vivo.
Empieza cuando quieras
Lo que dicen los estudiantes
Estas reseñas son de estudiantes inscritos que completaron al menos el 50% del curso. Moderamos las reseñas solo por motivos de contenido (spam, lenguaje ofensivo, datos personales), nunca por ser críticas o negativas.
Aún no hay reseñas aprobadas.
¡Sé el primero en compartir tu experiencia!