Documentación

Estado e incidentes en la documentación de NexoRouter.

Estado e incidentes

Estado: Entrada de soporte operativo.

Usa esta página cuando necesites decidir si un fallo de API viene de tu request, tu cuenta, límites del gateway de NexoRouter o un problema específico de modelo upstream.

Página de estado de NexoRouter

Dónde revisar primero

PreguntaRevisión
¿El sitio público o gateway está caído?Status
¿El request llegó a NexoRouter?Usage Logs
¿La cuenta puede consumir saldo?Billing
¿La key está enabled y con alcance correcto?API Keys
¿El modelo es público y vendible?Models
¿Qué significa el código de error?Manejo de errores

Triage rápido

  1. Prueba GET /v1/models con la misma key.
  2. Revisa si el request fallido aparece en Usage Logs.
  3. Si aparece, copia request ID, estado del resultado, model ID, latencia y error code.
  4. Prueba un request pequeño sin streaming con un modelo rápido conocido.
  5. Revisa Status para disponibilidad del gateway de NexoRouter y model gateway.
  6. Si solo falla un modelo, cambia de modelo temporalmente e incluye ambos model IDs en la nota de soporte.

Tabla de decisión

ObservaciónÁrea probableSiguiente acción
GET /v1/models falla con la misma keyKey, cuenta o gatewayRevisa API Keys, Billing y Status.
El request nunca aparece en Usage LogsCliente, red, base URL o provider mal configuradoConfirma base URL, proxy y selección de provider en la herramienta.
Usage Logs muestra invalid_api_keyKey o header de authSigue API key inválida.
Usage Logs muestra model_not_foundModel ID o alcance de modelos de la keyCopia el model ID desde Models y revisa el alcance de la key.
Usage Logs muestra error de quota/balanceBilling o presupuesto de keyRevisa Billing y crea una key de reemplazo si el presupuesto es bajo.
Un modelo falla pero otro funcionaUpstream específico del modelo o ruteo de modeloUsa temporalmente el modelo que funciona y reporta ambos model IDs.
Todos los modelos hacen timeout desde una redRed del cliente, proxy, firewall o regiónPrueba otra red o servidor y revisa Red/proxy.

Request pequeño para depurar

Usa un request pequeño sin streaming mientras depuras:

curl https://api.nexorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $NEXOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      { "role": "user", "content": "Reply with: ok" }
    ],
    "max_tokens": 16
  }'

Si esto funciona pero tu app sigue fallando, el problema probablemente está en configuración de app, tamaño del request, streaming, tool calling, proxy o elección de modelo.

Qué incluir en soporte

Request ID:
Model ID:
Endpoint:
Estado en Usage Logs:
HTTP status del cliente, si existe:
Error code:
Hora aproximada:
Cliente/herramienta:
Si /v1/models funciona:
Si un request pequeño sin streaming funciona:

No incluyas la API key completa. Si una key pudo filtrarse, revócala y crea una nueva antes de compartir diagnósticos.

Qué no inferir

  • Status puede mostrar disponibilidad de NexoRouter, pero no prueba que todos los modelos upstream estén sanos.
  • Un request de texto exitoso no prueba que streaming o tool calling funcionen para ese modelo.
  • Un modelo fuera del alcance de tu key no es lo mismo que un modelo no disponible globalmente.
  • Un timeout del cliente no siempre es una caída del gateway.

Relacionado

Estado e incidentes — NexoRouter