Introducción a ServBay AI Gateway

ServBay AI Gateway es una puerta de enlace local y unificada de proveedores de IA incorporada dentro de ServBay. Ejecuta un punto proxy en tu equipo, centralizando en un solo acceso las solicitudes a cerca de 20 proveedores destacados de modelos de IA (como OpenAI, Anthropic, DeepSeek, Qwen, entre otros). Así, puedes gestionar de manera centralizada tus llaves, controlar el uso y los costes, además de redirigir con un solo clic herramientas de programación de IA como Claude Code, Codex, Gemini CLI, etc., al gateway local.

Este documento presenta qué es el AI Gateway, los problemas que resuelve y su arquitectura general. Para operaciones específicas, consulta:

• Gestión de canales — Agregar y configurar proveedores
• Claves virtuales — Crear, limitar, rotar y revocar claves
• Toma de control de herramientas IA — Redirige CLI como Claude Code al gateway
• Estadísticas y monitoreo — Uso, coste y presupuesto
• Endpoints y variables de entorno — Integrar el gateway en tu propio código

Resumen

En el desarrollo diario de IA, es habitual contar con API Keys de múltiples proveedores, dispersas en archivos de configuración de distintos proyectos y herramientas, lo que dificulta controlar los gastos y el cambio de proveedor de forma unificada. ServBay AI Gateway centraliza estos aspectos:

• Un solo acceso para múltiples proveedores — Una vez configurados los canales, todas las solicitudes se enrutan a través de http://127.0.0.1:11580 en local; tu aplicación solo necesita conectar a una dirección.
• Claves virtuales en lugar de claves reales — El gateway emite "claves virtuales" que se suministran a tus aplicaciones y herramientas, manteniendo seguras las claves originales de los proveedores solo en el gateway. Puedes limitar, rotar o revocar las claves virtuales en cualquier momento.
• Vista unificada de uso y costes — Todas las solicitudes que pasan por el gateway quedan registradas. Se ofrecen estadísticas sobre número de solicitudes, uso de tokens, costes, latencia y uso multimodal, además de soporte para gestión de presupuestos.
• Toma de control de las principales herramientas de programación IA — Sin editar archivos de configuración manualmente, el gateway puede redirigir con un solo clic herramientas como Claude Code, Codex, Gemini CLI, Qwen Code, Kimi CLI, CodeBuddy, opencode, Crush, entre otras, para que utilicen el gateway local.

Arquitectura y puertos

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

Puerto	Uso	Descripción
11580	Puerto proxy	Punto de entrada unificado para aplicaciones. Tu código y las herramientas IA redirigidas envían solicitudes aquí, y el gateway las dirige al proveedor adecuado según los privilegios de la clave virtual.
11581	Puerto de gestión	Usado internamente por la app de ServBay para gestión de canales, claves y estadísticas. Normalmente no requiere acceso directo.

El puerto proxy ofrece endpoints en múltiples formatos compatibles (OpenAI, Anthropic, Gemini, etc.). Más detalles en Endpoints y variables de entorno.

Proveedores soportados

El AI Gateway incluye cerca de 20 proveedores predefinidos, organizados por categoría, para elegirlos fácilmente al agregar un canal:

• Principal (Mainstream): OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• China: DeepSeek, Qwen, Zhipu GLM, Kimi (Moonshot AI), Doubao·Volcano, Wenxin, Hunyuan, MiniMax, ZeroOne, StepStar. Entre ellos, Qwen, Zhipu GLM, Kimi, Doubao·Volcano, Hunyuan, MiniMax y StepStar soportan cambio de región nacional / global.
• Local: Ollama (por defecto 127.0.0.1:11434), LM Studio (por defecto 127.0.0.1:1234).
• Personalizados (Custom): Compatible con OpenAI (cualquier servicio compatible), Custom (totalmente personalizable).

Para el proceso completo de adición y configuración, consulta Gestión de canales.

Requisitos previos

• ServBay debe estar instalado y ejecutándose en macOS o Windows.
• El AI Gateway es una función premium de ServBay; es necesario iniciar sesión en tu cuenta de ServBay antes de agregar canales o claves. Si no has iniciado sesión, la interfaz te guiará para hacerlo.

TIP

La funcionalidad del AI Gateway es idéntica en ServBay para macOS y ServBay para Windows; los puertos proxy (11580), de gestión (11581) y las rutas de configuración de herramientas redirigidas son los mismos en ambas plataformas. Cualquier diferencia específica se aclarará en la documentación.

Cuenta y suscripciones

Ciertas capacidades del AI Gateway dependen de tu tipo de cuenta ServBay:

• Límite de canales / claves — El número máximo de canales y claves virtuales depende de si cuentas con una suscripción gratuita o de pago. Al alcanzar el límite, la interfaz te invitará a actualizar.
• Límites de uso y gestión de presupuesto — Restricciones por cuota (tokens / solicitudes / importe) y el dashboard de presupuestos están disponibles solo para planes VIP / de pago. Si no tienes suscripción, las áreas pertinentes aparecerán bloqueadas con indicaciones para actualizar.

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

Almacenamiento de datos

• La configuración de canales, claves virtuales y los registros de uso se mantienen localmente por el servicio backend del gateway.
• La clave virtual completa se muestra únicamente una vez al crear (o rotar); posteriormente, el gateway solo almacena el prefijo para identificación. ¡Asegúrate de copiar y guardar la clave al crearla!
• Al tomar el control de herramientas, el gateway primero guarda una copia de respaldo del archivo de configuración original como .bak, y luego escribe la configuración para apuntar al gateway local, facilitando su restauración cuando lo necesites.

Flujo de uso típico

1. Inicia sesión con tu cuenta ServBay y accede al AI Gateway.
2. En la sección Canales, añade al menos un canal de proveedor (por ejemplo, OpenAI o DeepSeek), introduce la API Key real y prueba la conexión.
3. En Claves virtuales, crea una clave virtual y limita los modelos / canales o la velocidad según lo necesites.
4. En la sección Endpoints, añade la clave virtual a tu aplicación, o desde el mismo lugar utiliza Toma de control para redirigir rápidamente tus herramientas de programación IA habituales.
5. En Estadísticas y monitoreo, sigue el consumo, costes y latencia, y ajusta tu presupuesto si lo requieres.

Resumen

ServBay AI Gateway transforma el desarrollo de IA—actualmente fragmentado entre múltiples proveedores, claves y herramientas—en una experiencia centralizada con "un solo gateway local, un conjunto de claves virtuales y una visión unificada del uso". Te permite gestionar recursos de IA de forma segura y local, controlar tus costes con precisión y conectar herramientas de desarrollo IA de manera uniforme y eficiente. Es una de las capacidades clave de ServBay para el desarrollo AI-native.