Solución de problemas

Busca el síntoma que coincida con lo que estás viendo. En casi todos los casos, la pestaña Logs es el diagnóstico más rápido: muestra el estado de cada solicitud y el patrón del fallo (¿una clave?, ¿un modelo?, ¿todo?). Consulta Actividad y registros.

Las solicitudes están bloqueadas

Todas las solicitudes fallan con 402 insufficient_credits

Causa: el módulo no está habilitado para esta instalación o el saldo prepago se agotó (la pestaña Overview mostrará "Your balance is depleted. Inference requests will be blocked until you top up."). En el caso de las claves de API, una instalación en la que Model Router no está habilitado devuelve en su lugar 403 "Model Router is not enabled for this facility".

Solución: habilita Model Router desde la página Welcome to Model Router (consulta Primeros pasos) y luego recarga saldo en Budgets & Limits → Balance & Top-up. Las solicitudes se reanudan pocos instantes después de que se acredita el saldo. Para evitar que vuelva a ocurrir, activa la recarga automática. Consulta Presupuestos y recargas.

Las solicitudes fallan con 402 budget_exceeded

Causa: se alcanzó un límite de gasto. El mensaje de error indica qué período (diario, mensual o total) y, en el caso de los límites diarios y mensuales, exactamente cuándo se restablece en la zona horaria de tu instalación. Puede tratarse del límite de toda la cuenta o de un límite de la clave o del servicio conectado específico (el mensaje dice "This key's" o "This agent's" cuando tiene ese alcance).

Solución: espera al restablecimiento indicado, aumenta el límite (Budgets & Limits → Spend Limits, o la configuración de la clave o del servicio) o, en el caso del tope máximo total, usa Reset hard cap. La página Spend Limits muestra exactamente qué límites están en "Limit reached".

Las solicitudes fallan con 403 content_policy_violation

Causa: el prompt coincidió con un filtro de contenido en modo block o con el escudo contra inyección de prompts.

Solución: revisa Settings → Guardrails. Si una integración necesita legítimamente reglas diferentes, usa su interruptor Override facility guardrails en lugar de flexibilizar la política de toda la instalación. Consulta Barreras de protección.

Las solicitudes fallan con 429

Causa: la clave o el servicio conectado superó su límite de frecuencia de Requests / min o Tokens / min.

Solución: espera y vuelve a intentarlo, o aumenta los límites de frecuencia en la configuración de la clave o del servicio (en blanco = ilimitado). Consulta Claves de API.

Un modelo específico devuelve errores y los demás funcionan

Causa: es posible que el modelo esté deshabilitado para tu instalación, que la restricción de modelos de la clave lo excluya o que el proveedor tenga problemas.

Solución: revisa Settings → Models (¿está habilitado?), la lista Restrict models de la clave y Activity → Performance → Reliability & performance by model para ver la tasa de errores del modelo a lo largo del tiempo.

Problemas con las claves de API

401 Unauthorized

Causa: con el código invalid_api_key ("Missing or invalid API key"), falta el encabezado Authorization: Bearer … o tiene un formato incorrecto. Sin código ("Invalid API key"), la clave es desconocida (está mal escrita o es un secreto antiguo después de una rotación) o fue revocada.

Solución: confirma el formato del encabezado y revisa el estado de la clave en Settings → Service Access & API Keys. Reactiva una clave revocada o actualiza tu servicio con el nuevo secreto si la clave se rotó.

Perdí el secreto de la clave

El secreto se muestra una sola vez al crearlo y no se puede recuperar. Usa Rotate: se emite un nuevo secreto (que se muestra una sola vez) y la clave conserva su etiqueta, sus límites y su historial. Actualiza todos los servicios que usan la clave: "You will need to reconfigure any services still using the old key."

La clave funciona, pero el uso aparece con un nombre incorrecto

Las claves se identifican por su Label en Activity y Logs. Edita la clave y asígnale una etiqueta significativa; dale a cada sistema su propia clave en lugar de compartir una.

Problemas con los agentes

Un agente aparece como Desconectado

Causa: el dispositivo está apagado o no tiene conectividad. Se trata de la conectividad del dispositivo, no de una configuración de Model Router.

Solución: revisa la alimentación y la red del dispositivo. Su configuración de acceso no se ve afectada y vuelve a funcionar en cuanto se reconecta.

Un agente dejó de responder a las solicitudes de IA

Revisa, en este orden:

1. Saldo: un saldo agotado bloquea a todos los agentes (el agente muestra un estado de créditos requeridos). Recarga saldo.
2. Límites por servicio: Settings → Service Access & API Keys → Connected Services: ¿el agente muestra "Limit reached"? Aumenta el límite o espera a que se restablezca.
3. Límites de la cuenta: Budgets & Limits → Spend Limits.
4. Registros: filtra por el agente para ver el error real de sus solicitudes.

Preguntas sobre saldo y facturación

Las cifras de gasto parecen atrasadas

Las cifras Available balance y Spent today se muestran en tiempo real. Monthly usage se concilia con tu saldo cada 15 minutos, por lo que el gasto muy reciente puede tardar unos minutos en aparecer allí. El historial de transacciones solo muestra recargas y ajustes de saldo, por lo que el uso nunca aparece en él.

La recarga automática no se ejecutó

Busca un aviso en la página Balance & Top-up: no hay tarjeta registrada, la tarjeta requiere autenticación o la tarjeta fue rechazada. Corrige la tarjeta (Update card / Edit payment details) o recarga saldo manualmente. Las comprobaciones de la recarga automática se ejecutan aproximadamente cada 15 minutos, por lo que un umbral recién superado puede tardar unos minutos en activarla.

Una recarga falló

"Additional card authentication is required. Please try again.": vuelve a intentarlo; es posible que tu banco te pida una verificación. "Top-up could not be completed.": el cargo fue rechazado; revisa la tarjeta o prueba con otro importe. No se aplica ningún crédito a menos que el cargo se realice correctamente.

Se me hizo el cargo, pero el saldo no cambió

Las recargas se acreditan al instante: actualiza la página. Si el saldo sigue sin reflejar un cargo realizado correctamente, anota el Transaction ID y el Payment reference del panel de detalles de la transacción (o de tu estado de cuenta de la tarjeta) y presenta una solicitud de soporte.

Preguntas sobre registros y análisis

Una solicitud que acabo de hacer todavía no aparece en Logs

Activa la actualización Live (o haz clic en Refresh now). Las solicitudes normalmente aparecen en pocos instantes; con mucha carga pueden tardar un poco más.

Los registros muestran un modelo que no solicité

Si enviaste model: "auto", los registros muestran el modelo al que se resolvió el Auto Router. Abre los detalles de la solicitud para ver Requested model: auto. Esto es lo esperado. Consulta Modelos.

Las filas muestran "No charge"

Las respuestas fallidas o vacías que no tienen costo llevan la insignia No charge: se registran para que el historial esté completo, pero no consumieron saldo.

Mi exportación CSV es más pequeña de lo esperado

Las exportaciones sin procesar tienen un límite de 25,000 filas: acota el rango de fechas o usa una exportación de resumen. Ten en cuenta también: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."