Primeros pasos

Esta guía lleva una instalación desde cero hasta una primera solicitud funcional en tres pasos y, después, muestra cómo comprobar que funcionó.

Antes de comenzar

• Debes ser Organisation Administrator. Model Router está disponible solo para los Organisation Administrators, en las instalaciones con Technology Stack.
• Selecciona la instalación que quieres configurar con el selector de instalación de la barra de herramientas principal de Performance Hub.
• Ten una tarjeta de facturación guardada para la instalación, o prepárate para agregar una. Las recargas se cobran en tu tarjeta de facturación guardada; si no hay ninguna registrada, la página Balance & Top-up muestra "No card on file." con un enlace Add payment details.

Paso 1: habilitar Model Router

Abre Model Router desde el menú principal (en el grupo AI Modules & Agents). Si el módulo todavía no se ha habilitado para esta instalación, verás la página Welcome to Model Router:

"Ofrece a tu empresa acceso prepago a un catálogo de modelos de IA líderes a través de un único extremo compatible con OpenAI. Tus AI Agents de Performance Hub se conectan automáticamente y puedes crear claves de API para integrar los mismos modelos en tu propio software, con Spend Limits y visibilidad total del uso."

Figura 1: La página Welcome to Model Router que ve una instalación antes de habilitar el módulo

La página tiene tres botones: Enable Model Router, Read the documentation (que abre esta documentación) y Explore first without enabling. Debajo, tres pasos describen la configuración:

Cada paso también tiene un enlace Learn more.

Haz clic en Enable Model Router (o en Enable module) para activar el módulo.

La lista de verificación de configuración

Después de habilitar el módulo, aparece un banner con la lista de verificación de configuración en la parte superior de Model Router hasta que se completa la configuración. Se titula Finish setting up Model Router y muestra una estimación del tiempo (por ejemplo, ~3 min left), cuántos pasos se completaron (por ejemplo, 2 of 3 complete) y un botón Resume que expande la lista completa. Cada paso tiene Review (o Review again) y Learn more; Collapse vuelve a contraerla. Cuando queda un solo paso, el subtítulo expandido dice "Just one step to go before AI requests start flowing. Steps can be done in any order."

Figura 2: El banner con la lista de verificación de configuración, que se muestra hasta que se completa la configuración

Los pasos obligatorios son Add a billing card, Top up your balance y Connect an agent or create an API key. Los pasos opcionales (Set spend limits, Turn on auto top-up y Verify your first request) se pueden descartar con Skip for now.

Paso 2: hacer tu primera recarga

Ve a Budgets & Limits → Balance & Top-up.

Figura 3: La tarjeta Top up balance (valores predefinidos, importe y tarjeta guardada) y la tarjeta Auto top-up

1. En la tarjeta Top up balance, elige un valor predefinido ($25, $50, $100, $250, $500, $1000) o escribe un importe. "Minimum top-up is $10."
2. Comprueba la tarjeta guardada que aparece debajo del importe (por ejemplo, "Amex ending 0005 · exp 06/29"). Usa Edit payment details si necesitas actualizarla.
3. Haz clic en Top up $–.––. Si se realiza correctamente, verás "Top-up successful. Your balance has been credited." Las recargas aparecen en el saldo al instante.

Recomendado: en la tarjeta Auto top-up, activa Enable auto top-up, establece When balance is below y Top up by (también con un mínimo de $10) y haz clic en Guardar cambios. A partir de entonces, se cobra automáticamente en tu tarjeta cada vez que el saldo baja del umbral, para que la inferencia nunca se detenga de forma inesperada. Consulta Presupuestos y recargas para obtener más detalles.

Paso 3: enviar tu primera solicitud

Elige la opción que corresponda a tu caso:

Si tienes AI Agents o Workflows

No hay nada que configurar: los dispositivos Agente de IA vinculados a esta instalación se conectan automáticamente, y los Workflows también pueden conectarse. Abre Settings (engranaje) → Service Access & API Keys y confirma que tu agente aparece en Connected Services con el estado En línea. Consulta Connected Services.

Si vas a conectar tu propio software

1. Abre Settings (engranaje) → Service Access & API Keys y haz clic en Create key. Copia el secreto del cuadro de diálogo "Copy your API key": "This is the only time the full key is shown. Store it somewhere safe."
2. Usa la Base URL y la solicitud de ejemplo que aparecen en la tarjeta Connecting to the API de la misma página. Una prueba mínima:

curl https://app.performancehub.co/ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "Hello"}]}'

Consulta Conectar tu aplicación para ver ejemplos en Python y TypeScript.

Paso 4: verificar

Abre la pestaña Logs. Tu solicitud de prueba debería aparecer en pocos instantes, con su modelo, los recuentos de tokens, el costo, la velocidad y un estado success. Si no aparece, consulta Solución de problemas.

Próximos pasos recomendados

• Establece límites de gasto: Budgets & Limits → Spend Limits. Un tope mensual es una red de seguridad sensata; consulta Presupuestos y recargas.
• Revisa el catálogo de modelos: Settings → Models. Todos los modelos están habilitados de forma predeterminada; usa los ajustes predefinidos rápidos para reducir el conjunto si tienes preferencias de proveedor o de presupuesto. Consulta Modelos.
• Considera las protecciones: Settings → Guardrails para el enmascaramiento de información de identificación personal, la ocultación de secretos y la protección contra la inyección de instrucciones. Ninguna está habilitada de forma predeterminada. Consulta Guardrails.