Referencia

En esta página

Tablas exhaustivas de Model Router. Para los conceptos y las guías de tareas, empieza por la descripción general.

Módulo

ElementoValor
Ubicación en el menúMenú principal → Model Router, en el grupo AI Modules & Agents
Quién puede accederSolo Organisation Administrators (instalaciones con Technology Stack).
AlcancePor instalación (selecciona la instalación en la barra de herramientas principal)
MonedaUSD

Recargas

ConfiguraciónValor
Recarga mínima$10
Recarga única máxima$5,000
Valores predefinidos$25, $50, $100, $250, $500, $1000
Método de pagoLa tarjeta de facturación guardada de la instalación
Momento de acreditación del saldoInstantáneo
ReciboNúmero de recibo + PDF descargable por cada recarga; también se envía por correo electrónico a los contactos de facturación de la instalación

Recarga automática

ConfiguraciónValor
ActivadorEl saldo baja del umbral When balance is below
Importe de la recargaTu importe de Top up by (mínimo $10)
Frecuencia de comprobaciónAproximadamente cada 15 minutos
Gestión de fallosSe muestra un banner cuando no hay ninguna tarjeta registrada, la tarjeta requiere autenticación o la tarjeta fue rechazada

Uso y conciliación

ElementoValor
Conciliación del usoCada 15 minutos con el saldo prepago; se muestra en Monthly usage, agrupado por mes calendario (UTC)
Available balanceEn tiempo real: el total acreditado menos el gasto en tiempo real (no solo el libro conciliado)
Estimated runwayEl gasto diario promedio de este mes proyectado sobre el saldo; se muestra como 0 days, 1 day, N days, 365+ days o Not enough data

Límites de gasto de la cuenta

LímiteRestablecimientoValores predefinidos
Daily limitTodos los días a medianoche, hora local de la instalación$25, $50, $100, $250
Monthly limitEl día 1 de cada mes, hora local de la instalación$50, $100, $250, $500, $1000
Total (hard cap)Solo restablecimiento manual (Reset hard cap: el contador vuelve a $0, el tope no cambia y el período cerrado se guarda en el historial de restablecimientos)—

Puede haber cualquier combinación activa. Los límites se aplican al conjunto de todas las claves de API y los servicios conectados; el saldo prepago se sigue aplicando además de estos. Cuando se superan, las solicitudes se bloquean con un error 402 budget_exceeded hasta que se restablece el período.

Configuración por clave y por servicio

ConfiguraciónValor predeterminadoNotas
LabelvacíoOpcional; se usa para atribuir el uso en Activity y Logs
Connection type (solo claves de API)API keyAPI key permanece en la lista de claves de API; External agent aparece en Connected Services
Daily spend limitdesactivadoSe restablece al comienzo de cada día, en la zona horaria de la instalación
Monthly spend limitdesactivadoSe restablece el día 1 de cada mes, en la zona horaria de la instalación
Lifetime capdesactivadoEl gasto total durante la vida útil de la clave o el servicio; nunca se restablece
Requests / minIlimitadoSuperarlo devuelve HTTP 429
Tokens / minIlimitadoSuperarlo devuelve HTTP 429
Restrict modelsdesactivado (todos los modelos habilitados en la instalación)Solo los modelos seleccionados se pueden usar con esta clave o este servicio
Override facility guardrailsdesactivado (hereda la configuración de la instalación)Cuando está activado, se aplica la selección propia de la clave o el servicio, incluida la opción "none"

Estados y acciones de las claves de API

EstadoSignificado
ActiveLa clave funciona.
Provisioning…Se muestra brevemente mientras se configura una clave nueva.
DisabledLa clave está revocada (la fila aparece atenuada); se puede reactivar.
Acción¿Reversible?Efecto
Edit—Cambia la etiqueta, los límites, los modelos y las protecciones.
RotateNoSe emite un nuevo secreto (que se muestra una sola vez); el secreto anterior deja de funcionar de inmediato.
RevokeSí (Re-activate)La clave se deshabilita de inmediato.
DeleteNoLa clave se elimina de forma permanente.

Modelos

ElementoValor
Valor predeterminadoTodos los modelos del catálogo habilitados
Automatically enable new modelsCuando está activado, los modelos que se agregan al catálogo se activan automáticamente para la instalación
Restricción"At least one model must stay enabled."
Ajustes predefinidos rápidosAll models, Frontier, Western providers, Open weights, Budget (precio de entrada ≤ $1.00 / 1M tokens)
FiltrosStatus (Any/Enabled/Disabled), Region (United States/Europe/China), Capability (Vision, Audio, PDF input, Reasoning)
OrdenaciónRecommended, Name, Price, Context size, en orden ascendente o descendente
Información por modeloVentana de contexto, precio de entrada y de salida por 1M tokens, iconos de capacidad (texto, imagen, audio, PDF), configuración de razonamiento

Enrutador automático

NivelDescripción
SimpleInstrucciones breves y sencillas
MediumTareas cotidianas
ComplexTrabajo difícil de varios pasos
ReasoningRazonamiento y análisis profundos
  • ID de modelo: auto; Usage-priced: se cobra la tarifa del modelo que elige el enrutador para cada solicitud.
  • El enrutamiento por instalación se puede editar con Edit routing (solo se pueden seleccionar modelos habilitados y cada nivel debe tener un modelo); Reset to default restaura la asignación estándar.
  • Logs y Activity muestran el modelo resuelto; el panel de la solicitud muestra auto como Requested model.

Medidas de protección

ProtecciónAcción al detectar una coincidencia
PII maskingEnmascara los datos personales de la instrucción; la solicitud continúa
Secret redactionElimina las claves, los tokens y los secretos de la instrucción; la solicitud continúa
Prompt-injection shieldBloquea la solicitud (403 content_policy_violation)
PlantillaHabilita
NoneNada (predeterminado)
PII protectionPII masking
Secret redactionSecret redaction
Injection shieldPrompt-injection shield
StrictLas tres

Filtros de contenido

ElementoValor
Cantidad máxima de filtros por instalación25
Longitud máxima del patrón300 caracteres
AccionesRedact (reescribe las coincidencias como [REDACTED]) o Block (rechaza con 403)
Seguridad de los patronesLas expresiones regulares no seguras (por ejemplo, patrones propensos al retroceso catastrófico) y los patrones de más de 300 caracteres se descartan y no se aplican
HerenciaPara toda la instalación; las claves y los servicios con la anulación de protecciones usan su propia lista

Historial de transacciones

El historial de transacciones solo muestra las recargas y los ajustes del saldo. El uso se resume en Monthly usage.

TipoSignificado
Top-upCargo en la tarjeta que acredita el saldo
RefundCargo reembolsado
AdjustmentCorrección manual del saldo
ElementoValor
ColumnasDate, Type, Amount, Balance after, Receipt
Recibos en bloqueMarca las filas y, después, haz clic en Download receipts (n)

Uso mensual

ElementoValor
AgrupaciónMes calendario (UTC); el mes en curso se marca como Month to date
ConciliaciónCada 15 minutos con el saldo prepago
ColumnasMonth, Usage, Deductions, Downloads
Tipo de deducciónUsage charge (gasto de inferencia conciliado), que se muestra al expandir un mes
Descargas por mesDownload usage statement (PDF) y Download usage detail (CSV)
NaturalezaEstados de uso, no facturas; solo las recargas con tarjeta tienen recibos

Actividad y registros

ElementoValor
Vistas de ActivityOverview, Trends, Performance, Explore
Rangos predefinidosLast 24 hours, Last 7 days, Last 30 days, Last 90 days, Year, All time, Custom range
Rangos predefinidos de LogsLast 15 minutes, Last hour, Last 24 hours (predeterminado), Last 7 days, Last 30 days, personalizado; actualización Live Off / 10s / 30s (predeterminado) / 60s
Opciones de agrupación de ExploreModel, API key / agent, Source, Provider, Status
Tope de la exportación CSV sin procesar25,000 filas
Tipos de exportaciónRaw requests; Summary by model / by key & agent / by source / by period (los resúmenes abarcan días completos)
Contenido almacenadoSolo metadatos, nunca el contenido de las instrucciones ni de las respuestas

Respuestas de error de la API

URL base: se muestra en Settings → Service Access & API Keys → Connecting to the API (por ejemplo, https://app.performancehub.co/ai/v1). Los errores usan el formato de OpenAI { "error": { "message", "type", "code" } }.

HTTPtypecodeSignificado
401invalid_request_errorinvalid_api_keyFalta la clave de API o las credenciales del servicio conectado no son válidas
401invalid_request_error—Clave de API desconocida o revocada ("Invalid API key")
402insufficient_quotainsufficient_creditsSe agotó el saldo prepago (o, en el caso de los servicios conectados, la instalación no está habilitada)
402insufficient_quotabudget_exceededSe alcanzó un límite de gasto (de la instalación, de la clave o del servicio conectado); el cuerpo incluye window, resetsAt, timezone y docsUrl
403invalid_request_error—"Model Router is not enabled for this facility" (claves de API) o "Facility has no provisioned inference key" (la clave no tiene una clave de inferencia asociada)
403invalid_request_errorcontent_policy_violationBloqueada por un filtro de contenido o por la protección contra la inyección de instrucciones
429——Se superó el límite de frecuencia de solicitudes por minuto o de tokens por minuto
502server_error—El servicio de inferencia de origen no está disponible (vuelve a intentarlo)

Un error inesperado al comprobar la clave de API devuelve HTTP 500 "Something went wrong"; vuelve a intentar la solicitud.

GET /v1/models sigue disponible con saldo cero.