Gestión de canales en la Pasarela AI

Un Canal en la pasarela AI es la configuración de un punto de acceso a un proveedor: guarda la dirección, la API Key real, los modelos disponibles, así como la información de tarificación y límites. La pasarela utiliza estos canales para enrutar las solicitudes de las aplicaciones al proveedor correspondiente. Este artículo explica cómo añadir, configurar, probar y gestionar canales.

Requisitos previos

• Tener ServBay instalado y en funcionamiento, y haber iniciado sesión en tu cuenta de ServBay (es necesario iniciar sesión antes de añadir canales).
• Disponer de la API Key real del proveedor objetivo (no es obligatorio para proveedores locales como Ollama o LM Studio).
• Si aún no conoces la arquitectura general de la pasarela AI, se recomienda leer primero la Introducción a la pasarela AI.

Añadir un canal

Dirígete a AI Gateway → Canales (Channels), y haz clic en Añadir (Add) para abrir el asistente. El asistente consta de tres pasos.

Paso 1: Elegir el proveedor

Los proveedores se agrupan por categoría; selecciona haciendo clic en la tarjeta:

• Principales: OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• China: DeepSeek, Qwen, Zhipu GLM, Kimi, Doubao·Huoshang, Wenxin Yiyan, Hunyuan, MiniMax, Zero One, StepStar.
• Locales: Ollama, LM Studio.
• Personalizados: OpenAI Compatible, Custom.

Tras seleccionar el proveedor, la pasarela rellenará automáticamente el Base URL por defecto de ese proveedor.

Cambio de región dual

Proveedores chinos como Qwen, Zhipu GLM, Kimi, Doubao·Huoshang, Hunyuan, MiniMax, StepStar, entre otros, ofrecen endpoints para China y globales. Al seleccionar uno de estos, aparece el selector de región (🇨🇳 China / 🌐 Global); al cambiar, el Base URL se actualiza automáticamente según la región.

Paso 2: Configuración

• Nombre del canal (obligatorio): Identifica el canal en la lista; puedes personalizarlo.
• Base URL (obligatorio): Dirección de la API del proveedor. Ya vendrá rellenada para la mayoría excepto Azure OpenAI y Custom, que debes introducir manualmente.
• API Key (opcional): Clave real del proveedor. Si la dejas en blanco, solo podrás probar la conectividad del endpoint, pero no se validará la clave; para proveedores locales normalmente no es necesario.
• Modelos: Tienes dos opciones, elige una:
  • Descubrimiento automático: Haz clic en "descubrir" y la pasarela consultará la lista de modelos del proveedor, para que selecciones mediante etiquetas.
  • Introducción manual: Escribe directamente el nombre del modelo. Para Azure, introduce el nombre de despliegue (Deployment name), no el nombre del modelo.
• Prioridad / Peso: Si varios canales soportan un mismo modelo, la pasarela los usará para decidir el enrutamiento y distribución de carga.

Atención Azure OpenAI

En canales Azure, el campo "Modelos" debe contener el nombre de despliegue creado en el portal de Azure, no el nombre del modelo subyacente. El Base URL también debe ser el endpoint de tu recurso Azure.

Paso 3: Confirmar y enviar

Revisa la configuración y envía. Al crearse con éxito, el nuevo canal aparecerá en la lista, mostrando su estado de salud en tiempo real.

Test de conectividad

En la lista de canales puedes probar la conectividad de cualquiera de ellos. El test evalúa dos aspectos:

• Accesibilidad del endpoint (reachable): Verifica si el Base URL es accesible (red y dirección correctas).
• Validez de la clave (authenticated): Llama realmente a la API del proveedor y comprueba si la API Key es válida. Solo se verifica si se ha introducido la API Key.

El resultado muestra: latencia de ida y vuelta (ms), estado, y mensajes de error si los hay.

TIP

Durante el asistente, si no se puede alcanzar el endpoint, no podrás continuar al siguiente paso; si el endpoint es accesible pero la clave es inválida, solo se mostrará una advertencia, permitiéndote continuar (por ejemplo, si planeas añadir la clave más tarde).

Configuración avanzada

Al crear o editar un canal, puedes acceder a configuraciones avanzadas para el control de costes y cuotas:

• Multiplicador de tarifa (Rate Multiplier): Multiplicador sobre el precio oficial del proveedor, útil para ajustar según tu coste real o precio de reventa. Valor por defecto: 1.0.
• Modelo de facturación: Indica el tipo de facturación del canal, como pago por uso, suscripción o paquete.
• Saldo: El origen puede ser un valor fijo, una factura OSS o mantenimiento manual; al elegir factura OSS puedes especificar el tipo de factura. El saldo y la última actualización son solo lectura en detalle del canal.
• Fecha de vencimiento de suscripción: Para canales tipo suscripción/paquete puedes registrar la fecha límite.
• Límite de cuota (VIP): Puedes establecer un límite por tokens, número de solicitudes o importe, con un periodo a elegir (diario / semanal / mensual / personalizado); también puedes activar “permitir desvío” para tolerar cierto exceso. Esta función es para usuarios premium.

Editar y eliminar canales

• Editar: Abre un canal en la lista para modificar su nombre, Base URL, API Key, modelos u opciones avanzadas.
• Eliminar: Al borrar un canal, cualquier clave virtual que dependa de él ya no podrá enrutar peticiones; hazlo con precaución.

Estado de salud

Tanto la lista de canales como la página de estadísticas muestran en tiempo real el estado de cada canal (operativo / degradado / no disponible), facilitando la rápida detección de configuraciones no válidas.

Preguntas Frecuentes (FAQ)

• P: ¿Aparece un mensaje solicitando iniciar sesión al añadir un canal?
  • R: La pasarela AI es una función premium de ServBay; debes iniciar sesión en tu cuenta ServBay antes de añadir canales o claves, siguiendo las instrucciones en pantalla.
• P: ¿Mensaje de límite de canales alcanzado?
  • R: El número de canales depende de tu plan de cuenta. Si llegas al límite, elimina canales no utilizados o mejora tu plan.
• P: ¿Fallo en el descubrimiento automático de modelos?
  • R: Verifica primero que el Base URL es correcto y la API Key es válida (puedes usar el test de “validez de clave” de conectividad); algunos proveedores requieren clave válida para mostrar los modelos. Si es necesario, introduce los nombres manualmente.
• P: ¿Hace falta poner clave para conectar Ollama/LM Studio local?
  • R: Normalmente no. Solo asegúrate de que el servicio local está ejecutándose y escuchando en el puerto por defecto (Ollama 11434, LM Studio 1234).

Resumen

Los canales son la base para enrutar solicitudes en la pasarela AI. El asistente de tres pasos permite conectar rápidamente casi 20 proveedores, con soporte para conmutación regional, descubrimiento automático de modelos y test de conectividad en dos niveles para asegurar la correcta configuración. Gracias a la tarificación avanzada y control de cuotas, puedes gestionar los costes al detalle. Una vez creados los canales, puedes generar claves virtuales para que aplicaciones y herramientas los usen.