yzapi
YZ AI Gateway es una puerta de entrada escalable para equipos que unifica múltiples proveedores de modelos de lenguaje (OpenAI, Anthropic, Gemini) y herramientas de codificación (Claude Code, Codex, Cursor).
Ficha actualizada 24 sept 2026, 6:04 · upstream 24 sept 2026, 5:40 · release v1.0.51
Qué es yzapi
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
YZ AI Gateway actúa como una capa de abstracción que permite a los equipos utilizar múltiples proveedores de modelos de lenguaje (como OpenAI, Anthropic, Google Gemini) y herramientas de codificación específicas (Claude Code, Codex, OpenCode, Gemini CLI, Cursor) a través de un único endpoint. La arquitectura se basa en Go para el backend y React para la interfaz, con soporte nativo para SQLite y PostgreSQL. Su principal valor reside en la capacidad de gestionar cuentas, permisos y límites de uso desde una consola centralizada, simplificando la rotación de claves y la gestión de modelos sin tocar los clientes.
- Unificar múltiples proveedores de LLM (OpenAI, Anthropic, Gemini) detrás de un único endpoint para simplificar la configuración en herramientas como Claude Code o Cursor.
- Gestionar costes y cuotas por usuario o grupo mediante límites de tokens, concurrencia y precios dinámicos sincronizados con LiteLLM.
- Implementar alta disponibilidad mediante grupos de modelos ordenados con failover automático y monitoreo de salud de cuentas upstream.
- Auditar el uso de modelos sensibles mediante coincidencia de patrones de palabras clave y almacenamiento de cuerpos de solicitud en Elasticsearch opcional.
- Conversión de protocolos nativa: soporta Anthropic Messages, OpenAI Chat/Responses y Gemini, permitiendo que herramientas como Claude Code usen proveedores solo compatibles con OpenAI.
- Persistencia híbrida: SQLite por defecto para despliegues simples, con soporte para PostgreSQL en configuraciones multi-instancia o alta disponibilidad.
- Gestión de costes granular: captura precios en el momento de la llamada y permite reportes detallados por usuario, modelo y proveedor.
- Enrutamiento inteligente: soporta reglas de contexto, similaridad vectorial y nombres virtuales de modelos para optimizar el tráfico hacia proveedores específicos.
- La latencia introduce un overhead medible en la primera respuesta (TTFB), especialmente con cuerpos grandes (>1 MB), aunque no es el cuello de botella principal.
- El almacenamiento de cuerpos de solicitud para auditoría requiere Elasticsearch adicional y consume recursos extra, siendo opcional.
- La alta disponibilidad requiere compartir secretos entre instancias y configurar manualmente la sincronización de claves de credenciales cifradas.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para producción, utilice PostgreSQL en lugar de SQLite para evitar problemas de concurrencia. Configure `YZAPI_JWT_SECRET` compartido entre instancias si se usa alta disponibilidad. Asegúrese de que el volumen de datos (`YZAPI_DATA_DIR`) tenga permisos correctos y considere usar un proxy inverso (Nginx) para manejar CORS y terminación SSL. El despliegue binario es ligero, pero Docker Compose con perfil PostgreSQL simplifica la configuración inicial.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.