One API y New API son proyectos populares de gateway de API de IA de código abierto. Consolidan varios proveedores de modelos detrás de una única interfaz compatible con OpenAI. A medida que crece el uso, muchos equipos empiezan a preguntarse si conviene construir su propio gateway o usar un servicio gestionado.

Este artículo explica la diferencia, qué requiere el autoalojamiento, cuándo tiene sentido y cómo migrar.

Nota: One API y New API son los nombres de sus respectivos proyectos y titulares de derechos. Este artículo es solo para debate técnico. Para funciones y licencias concretas, consulta los repositorios de los proyectos.

1. Qué son One API y New API

Ambos son, en esencia, gateways de API:

Your app → gateway (keys / quotas / routing / logs) → OpenAI / Claude / Gemini / DeepSeek

Las capacidades habituales incluyen:

  • Una interfaz compatible con OpenAI.
  • Gestión de múltiples canales y modelos.
  • Usuarios, tokens, cuotas y grupos.
  • Logs de uso y facturación.
  • Limitación de velocidad, reintentos y conmutación por error entre canales.
  • Un panel de administración.

One API apareció antes; New API es uno de los proyectos que siguió evolucionando en su ecosistema, con un conjunto de funciones y una interfaz de administración más modernos. Ambos son adecuados para equipos con cierta capacidad técnica para autoalojar.

2. Qué requiere el autoalojamiento

1. Un servidor

Un servidor Linux que pueda ejecutar Docker. Las especificaciones dependen de la concurrencia y el volumen de logs. Un equipo pequeño no necesita una máquina potente para empezar, pero el ancho de banda y el espacio en disco importan.

2. Una base de datos

Las opciones habituales son SQLite por simplicidad, MySQL o PostgreSQL. Para producción, prioriza MySQL o PostgreSQL y configura copias de seguridad fiables.

3. Redis (opcional pero recomendable)

Se usa para caché, sesiones, limitación de velocidad y tareas similares. Gana importancia en despliegues con varios nodos.

4. Un dominio y HTTPS

Necesitas un dominio, DNS, un proxy inverso como Caddy o Nginx y certificados. Los callbacks de pago y el inicio de sesión OAuth requieren HTTPS público.

5. Cuentas y canales upstream

Debes aportar tus propias claves o canales upstream para OpenAI, Claude, Gemini, DeepSeek y otros. El gateway en sí no proporciona cuota de modelos.

6. Operaciones

Incluye actualizaciones, copias de seguridad, monitorización, logs, parches de seguridad, conciliación de pagos y alertas. Son los principales costes ocultos del autoalojamiento.

3. Autoalojado vs. gestionado

Dimensión One API/New API autoalojado Servicio gestionado (como ZSQH)
Coste inicial Servidor, dominio y tiempo Registrarse y usar
Control de datos Alto; los datos se quedan en tu servidor Depende de las condiciones del proveedor
Canales de modelo Tú los solicitas y los mantienes Los proporciona la plataforma
Operaciones Tu responsabilidad Responsabilidad de la plataforma
Actualizaciones y seguridad Te encargas tú Se encarga la plataforma
Pagos y facturas Los gestionas tú Los gestiona la plataforma
Personalización Alta Limitada por las funciones de la plataforma
Ideal para Equipos con ingenieros y necesidades profundas de personalización Equipos que quieren lanzar rápido con menos trabajo de operación

4. Pasos generales de autoalojamiento

1. Prepara el servidor y el dominio

Instala Docker, apunta el dominio y configura el firewall. Expón solo los puertos 22, 80 y 443; no expongas la base de datos ni Redis a Internet.

2. Despliega la base de datos y Redis

Usa contraseñas aleatorias robustas, configura volúmenes persistentes y haz copias de seguridad diarias.

3. Despliega el gateway

Arranca la aplicación, la base de datos y Redis con Docker Compose. Configura variables de entorno para:

  • La conexión a la base de datos.
  • La conexión a Redis.
  • El secreto de sesión.
  • La dirección del sitio.
  • CORS y dominios de confianza.

4. Configura el proxy inverso y HTTPS

Envía el tráfico de Caddy o Nginx al puerto de la aplicación y activa HTTPS y HSTS.

5. Configura los canales upstream

Añade canales, modelos, grupos y multiplicadores en el panel de administración. Valida primero con una clave de prueba pequeña.

6. Configura pagos y OAuth (opcional)

Los callbacks de pago y el inicio de sesión con Google o GitHub requieren HTTPS público y URLs de callback correctas.

7. Monitorización y copias de seguridad

Como mínimo, configura monitorización de disponibilidad, logs de errores, copias de seguridad de la base de datos y alertas de disco.

5. Cuándo tiene sentido el autoalojamiento

  • Tienes un equipo de ingeniería que puede encargarse de servidores y actualizaciones.
  • Los datos deben permanecer en tus propios servidores.
  • Necesitas personalización profunda de enrutamiento, facturación o permisos.
  • Los canales upstream son estables y puedes mantenerlos tú mismo.
  • El uso es lo bastante alto como para que las comisiones del servicio gestionado superen claramente el coste total del autoalojamiento.

6. Cuándo no tiene sentido el autoalojamiento

  • No tienes personal de operaciones.
  • Solo quieres lanzar y validar un producto rápidamente.
  • No puedes resolver las cuentas upstream, el pago o el cumplimiento.
  • No puedes garantizar actualizaciones de seguridad y copias de seguridad.
  • Tu objetivo principal es ahorrar un poco en las tarifas de API.

El autoalojamiento no es gratuito. Servidores, dominios, certificados, copias de seguridad, monitorización, resolución de problemas y actualizaciones de seguridad cuestan dinero.

7. Migrar a un servicio gestionado

Si ya autoalojas pero quieres pasar a un servicio gestionado:

  1. Exporta las configuraciones de usuarios, tokens y canales solo para inventario. No expongas claves.
  2. Crea una cuenta y claves en la plataforma gestionada.
  3. Cambia la Base URL por la dirección gestionada.
  4. Asigna tus nombres de modelo.
  5. Ejecuta una prueba canaria con poco tráfico durante 3–7 días.
  6. Mantén la instancia autoalojada como respaldo y retírala solo cuando el nuevo servicio sea estable.

8. Preguntas frecuentes

¿Es New API mejor que One API?

Depende de tus requisitos, versiones y capacidad de mantenimiento. Fíjate en la actividad del proyecto, la documentación, la licencia, la comunidad y tu stack tecnológico, no solo en una lista de funciones.

¿Puede un gateway autoalojado llamar directamente a modelos oficiales?

Sí, pero debes aportar tú mismo las claves o canales upstream y cumplir las condiciones de cada proveedor.

¿Cuánto cuesta el autoalojamiento?

Servidores, dominios, copias de seguridad, monitorización y mano de obra cuentan. Los despliegues pequeños pueden ser baratos, pero la alta disponibilidad, las copias de seguridad y la seguridad de nivel empresarial requieren una inversión real.

¿Un servicio gestionado me deja atado?

Depende de si mantienes la Base URL y los nombres de modelo en la configuración. Si conservas la compatibilidad con OpenAI y una configuración basada en parámetros, los costes de migración bajan mucho.

Próximos pasos

Si no quieres mantener servidores, bases de datos, pagos y actualizaciones, empieza con el gateway gestionado ZSQH AI Gateway y pon en marcha tu negocio; si el autoalojamiento es obligatorio, usa la lista anterior para evaluar los costes de mano de obra y seguridad. Los nombres de modelo y los precios están en Precios de modelos.

Lecturas relacionadas: