Sub2API

¿Qué es Sub2API?

Sub2API es un gateway de API de IA open source que distribuye y gestiona cuotas de suscripción entre varias cuentas upstream. En lugar de que cada usuario se integre directamente con servicios de IA upstream, Sub2API proporciona claves API generadas por la plataforma mientras maneja la autenticación, contabilidad relacionada con facturación, balanceo de carga y reenvío de solicitudes.

El proyecto está diseñado para configuraciones donde varias cuentas upstream deben agruparse y servirse a través de un gateway consistente, incluyendo funciones como soporte multi-cuenta, programación consciente de cuotas y controles para concurrencia y limitación de tasa.

Características clave

• Gestión multi-cuenta para conexiones upstream (soporta varios tipos de cuentas upstream como OAuth y API Key), permitiendo que un gateway sirva varias cuentas upstream.
• Distribución de claves API (genera y gestiona claves API para usuarios), para que los usuarios se autentiquen contra Sub2API en lugar de manejar múltiples credenciales upstream.
• Seguimiento de uso a nivel de token y cálculo de costos, utilizado para rastrear y calcular el uso a nivel de token para contabilidad relacionada con facturación.
• Programación inteligente con sesiones sticky, que selecciona cuentas upstream de forma inteligente manteniendo el enrutamiento de sesiones estable en entornos multi-cuenta.
• Control de concurrencia y limitación de tasa configurable (límites de concurrencia por usuario y por cuenta; límites de tasa de solicitudes y tokens), para prevenir sobrecargas y gestionar el rendimiento.
• Panel de administración para monitoreo y gestión a través de una interfaz web.
• Integración con sistemas externos para extender el panel de administración usando iframes (p. ej., incrustar sistemas de pago o ticketing).

Cómo usar Sub2API

1. Decide si quieres autoalojarlo o usar el servicio de relay oficial. El repositorio menciona un relay oficial, PinCC, para usuarios que no quieran autoalojarlo.
2. Si autoalojas, instala Sub2API en un servidor Linux (amd64 o arm64) con PostgreSQL 15+ y Redis 7+ disponibles.
3. Instala usando el script de un clic proporcionado en el repositorio, luego inicia el servicio y habilítalo al arranque.
4. Abre el asistente de configuración en tu navegador (el README referencia http://YOUR_SERVER_IP:8080) para configurar ajustes de base de datos/Redis y crear una cuenta de administrador.
5. Desde el panel de administración, gestiona ajustes y claves API de usuarios; los usuarios llaman a servicios de IA upstream a través de la plataforma usando sus claves API emitidas por Sub2API.

Casos de uso

• Agrupación de múltiples cuentas de suscripción upstream: usa Sub2API para centralizar el uso de cuotas y servir usuarios a través de un gateway único mientras distribuye solicitudes entre cuentas upstream.
• Distribución de cuotas para equipos: da a los miembros del equipo claves API individuales de Sub2API mientras Sub2API rastrea el uso a nivel de token y gestiona programación y límites.
• Gestión de rendimiento con límites: configura límites de concurrencia por usuario y por cuenta más límites de tasa de solicitudes/tokens para moldear la carga y reducir el riesgo de saturación upstream.
• Visibilidad operativa y administración: usa el panel de administración integrado para monitorear y gestionar el gateway en lugar de depender solo de paneles de proveedores upstream.
• Extensión de flujos de trabajo internos: incrusta sistemas externos (como pagos o ticketing) en el panel de administración usando iframes para soportar procesos operativos.

Preguntas frecuentes

• ¿Está Sub2API ligado a un dominio específico? El repositorio indica que Sub2API usa oficialmente solo sub2api.org y pincc.ai. Otros sitios que usan el nombre Sub2API pueden ser despliegues de terceros y no están afiliados; los usuarios deben verificar independientemente.

• ¿Cómo despliego Sub2API? El proyecto documenta dos métodos de despliegue: instalar vía un script que descarga binarios precompilados de GitHub Releases, o desplegar con Docker Compose (incluyendo contenedores de PostgreSQL y Redis).

• ¿Qué cuentas upstream soporta Sub2API? Soporta múltiples tipos de cuentas upstream, incluyendo OAuth y API Key (como se indica en la lista de características).

• ¿Qué debo hacer al usar Nginx como proxy inverso? El README indica que si usas Nginx con Sub2API (o CRS) y Codex CLI, debes agregar underscores_in_headers on; dentro del bloque http, porque Nginx elimina encabezados con guiones bajos por defecto y eso puede romper el enrutamiento de sesiones sticky en configuraciones multi-cuenta.

Alternativas

• Usa el servicio de relay oficial (PinCC): si no quieres autoalojar Sub2API, el repositorio apunta a PinCC como el relay oficial basado en Sub2API, diseñado para usuarios que quieren acceso inmediato sin despliegue/mantenimiento.
• Usa un gateway de API autogestionado para cuotas y enrutamiento: si ya gestionas infraestructura, puedes buscar soluciones de gateway/gestión de rutas que soporten claves de API, autenticación, limitación de tasa y reenvío de solicitudes; a diferencia de Sub2API, podrían no incluir seguimiento de uso a nivel de token y distribución de cuotas orientada a suscripciones de IA.
• Construye un servicio proxy personalizado: puedes implementar un proxy de capa de aplicación que enrute solicitudes a proveedores de IA upstream y aplique límites; en comparación con Sub2API, esto suele requerir más trabajo de ingeniería para funciones como sesiones persistentes y contabilidad a nivel de token.
• Usa un enfoque de gestión de API multiinquilino: las plataformas generales de gestión de API pueden centralizar autenticación y throttling, pero podrían necesitar personalización adicional para igualar la distribución de cuotas y el flujo de contabilidad de uso basado en tokens de Sub2API.