Introducción a ServBay AI Gateway

ServBay AI Gateway es un gateway local unificado de proveedores de IA integrado en ServBay. Ejecuta un endpoint de proxy en tu máquina que centraliza las solicitudes dirigidas a distintos proveedores de grandes modelos (OpenAI, Anthropic, DeepSeek, Qwen y casi 20 más) en un único punto de entrada. Esto te ayuda a gestionar las claves de forma centralizada, monitorizar el uso y los costes, y apuntar con un solo clic herramientas de programación con IA como Claude Code o Codex al gateway local.

Este documento presenta qué es AI Gateway, qué problemas resuelve y su arquitectura general. Para los procedimientos específicos, consulta:

• Gestionar canales — Añadir y configurar cada proveedor
• Claves virtuales — Crear, limitar permisos, rotar y revocar claves
• Toma de control de herramientas de programación con IA con un clic — Apuntar CLI como Claude Code al gateway
• Estadísticas y monitorización — Uso, costes y presupuestos
• Endpoints y variables de entorno — Llamar al gateway desde tu propio código

Descripción general

En el desarrollo diario con IA, es posible que tengas API Keys de varios proveedores dispersas en archivos de configuración de distintos proyectos y herramientas, lo que dificulta calcular los gastos o cambiar de proveedor de forma unificada. ServBay AI Gateway centraliza estos problemas en un solo lugar:

• Un único punto de entrada para varios proveedores — Una vez configurados los canales, todas las solicitudes se reenvían a través de http://127.0.0.1:11580, de modo que tu aplicación solo tiene que tratar con una única dirección.
• Claves virtuales en lugar de claves reales — El gateway emite «claves virtuales» para aplicaciones y herramientas, mientras que las API Keys reales de los proveedores solo se guardan en el lado del gateway y ya no quedan dispersas por todas partes. Las claves virtuales se pueden limitar, rotar y revocar en cualquier momento.
• Vista unificada de uso y costes — Todas las solicitudes que pasan por el gateway quedan registradas. El gateway ofrece estadísticas de número de solicitudes, uso de tokens, costes, latencia, uso multimodal, etc., y admite gestión de presupuestos.
• Toma de control de las principales herramientas de programación con IA con un clic — Sin necesidad de modificar manualmente archivos de configuración, el gateway puede apuntar con un solo clic herramientas como Claude Code, Codex, Qwen Code, Kimi CLI, CodeBuddy, opencode, Crush, etc. al gateway local.
• Seguimiento de cuentas de suscripción y cuotas — Admite la vinculación de cuentas de proveedor de tipo suscripción (como la autorización OAuth de Claude Pro / Max), muestra visualmente dentro del gateway la información del plan, los endpoints disponibles y los límites de longitud de salida, y realiza un seguimiento en tiempo real de las cuotas multiventana (porcentaje usado / restante, estado de agotamiento de la cuota, hora de restablecimiento), para que conozcas en todo momento el saldo de la suscripción.
• Detección de capacidades del canal y enrutamiento inteligente — Al añadir un canal, el gateway detecta automáticamente las capacidades del proveedor (tipo de autorización OAuth / tipo de plan de codificación / tipo de modelo por niveles). Tras la confirmación, escribe automáticamente un mapeo de tres niveles en el gateway según el resultado de la detección, sin necesidad de adivinar manualmente la compatibilidad de los modelos.

Arquitectura y puertos

AI Gateway consta de dos servicios locales, y ambos escuchan únicamente en la dirección de loopback (127.0.0.1):

Puerto	Uso	Descripción
11580	Puerto de proxy	Punto de entrada unificado para aplicaciones. Tu código y las herramientas de IA controladas envían sus solicitudes aquí; el gateway las enruta al canal de proveedor correspondiente según los permisos de la clave virtual.
11581	Puerto de administración	Utilizado internamente por la aplicación ServBay para gestionar canales, claves y datos estadísticos; normalmente no es necesario acceder a él directamente.

El puerto de proxy ofrece además endpoints en varios formatos compatibles (compatible con OpenAI, compatible con Anthropic, compatible con Gemini); consulta Endpoints y variables de entorno para más detalles.

Canales de proveedores compatibles

AI Gateway incluye casi 20 preajustes de proveedores, agrupados por categoría, que puedes seleccionar directamente al añadir un canal:

• Principales (Mainstream): OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• China: DeepSeek, Qwen, Zhipu GLM, Kimi (Moonshot AI), Doubao · Volcano, ERNIE Bot, Hunyuan, MiniMax, 01.AI, StepFun. Entre ellos, Qwen, Zhipu GLM, Kimi, Doubao · Volcano, Hunyuan, MiniMax, StepFun, etc., admiten conmutación de endpoints de doble región: China / global.
• Locales (Local): Ollama (por defecto 127.0.0.1:11434), LM Studio (por defecto 127.0.0.1:1234).
• Personalizados (Custom): OpenAI Compatible (cualquier servicio compatible con OpenAI), Custom (totalmente personalizado).

Para consultar el proceso completo de adición y configuración, véase Gestionar canales.

Requisitos previos

• Tener ServBay instalado y en ejecución en macOS o Windows.
• AI Gateway es una función de valor añadido de ServBay; antes de añadir canales / claves, debes iniciar sesión en tu cuenta de ServBay. Si no has iniciado sesión, la interfaz te guiará para hacerlo.

TIP

AI Gateway ofrece las mismas funciones en ServBay for macOS y ServBay for Windows; el puerto de proxy (11580), el puerto de administración (11581) y las rutas de los archivos de configuración de las herramientas controladas son idénticos. Si existe alguna diferencia entre plataformas, se indicará por separado en la documentación.

Cuenta y plan

Algunas capacidades de AI Gateway están vinculadas al plan de tu cuenta de ServBay:

• Límite de canales / claves — Los planes gratuitos y de pago permiten crear un número diferente de canales y claves virtuales. Al alcanzar el límite, la interfaz te pedirá que actualices.
• Gestión de cuotas y presupuestos — Los límites por cuota (tokens / número de solicitudes / importe) y el panel de presupuesto son capacidades VIP / de pago; si no tienes suscripción, el área correspondiente aparecerá bloqueada y se te sugerirá actualizar.

Para más detalles sobre los planes, consulta ServBay Pro y ServBay Team.

Seguimiento de cuentas de suscripción y cuotas

AI Gateway admite la vinculación de cuentas de proveedor de tipo suscripción (como Claude Pro / Max conectados mediante autorización OAuth), lo que te permite ver y gestionar estos recursos de suscripción directamente dentro del gateway local, sin necesidad de iniciar sesión en la consola web de cada proveedor.

Qué puedes hacer con las cuentas de suscripción

• Información del plan de un vistazo — Muestra el nombre del plan de suscripción, la estructura de facturación y el período de validez.
• Endpoints disponibles y límites de salida — Consulta la lista de endpoints que puede invocar la cuenta de suscripción y el límite máximo de longitud de salida de cada modelo.
• Seguimiento de cuotas multiventana — Muestra visualmente el porcentaje de cuota usada / restante, si se ha agotado actualmente y la hora de restablecimiento de la cuota, para ayudarte a distribuir razonablemente los recursos de la suscripción.
• Visibilidad de credenciales caducadas — Cuando las credenciales de autorización de la cuenta de suscripción caducan o dejan de ser válidas, la interfaz lo marca claramente para recordarte que debes volver a autorizar.

Función experimental

La conexión mediante autorización OAuth de cuentas de suscripción es actualmente una función experimental, y los proveedores compatibles se ampliarán gradualmente. Durante la autorización, deberás completar el flujo OAuth del proveedor en el navegador; el token de autorización solo se almacena localmente.

Almacenamiento de datos

• Los datos como la configuración de canales, las claves virtuales y las estadísticas de uso son mantenidos localmente por el servicio backend del gateway.
• El texto plano de la clave virtual solo se muestra una vez al crearla (o rotarla); después, el gateway solo conserva el prefijo para su identificación. Asegúrate de copiarla y guardarla inmediatamente al crearla.
• Al tomar el control de cada herramienta con un clic, el gateway primero hace una copia de seguridad del archivo de configuración original de la herramienta de destino con el sufijo .bak, y luego escribe la configuración que apunta al gateway local, para que puedas restaurarla en cualquier momento.

Flujo de uso típico

1. Inicia sesión en tu cuenta de ServBay y accede a AI Gateway.
2. En la página Canales, añade al menos un canal de proveedor (como OpenAI o DeepSeek), introduce la API Key real y prueba la conectividad.
3. En la página Claves virtuales, crea una clave virtual y limita según sea necesario los modelos / canales disponibles y la velocidad.
4. En la página Endpoints, introduce la clave virtual en tu aplicación, o en la misma página Toma el control con un clic de tus herramientas de programación con IA habituales.
5. En la página Estadísticas y monitorización, observa el uso, el coste y la latencia, y establece un presupuesto si es necesario.

Resumen

ServBay AI Gateway convierte la situación fragmentada del desarrollo con IA —múltiples proveedores, múltiples claves, múltiples herramientas— en «un único punto de entrada local, un conjunto de claves virtuales y una única vista de uso». Te permite gestionar de forma segura y centralizada las capacidades de IA en local, controlar con precisión los costes y conectar diversas herramientas de programación con IA a un gateway unificado con el mínimo esfuerzo. Es una de las capacidades principales de ServBay para el desarrollo nativo de IA.