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.

Dónde revisar primero
| Pregunta | Revisió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
- Prueba
GET /v1/modelscon la misma key. - Revisa si el request fallido aparece en Usage Logs.
- Si aparece, copia request ID, estado del resultado, model ID, latencia y error code.
- Prueba un request pequeño sin streaming con un modelo rápido conocido.
- Revisa Status para disponibilidad del gateway de NexoRouter y model gateway.
- 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 probable | Siguiente acción |
|---|---|---|
GET /v1/models falla con la misma key | Key, cuenta o gateway | Revisa API Keys, Billing y Status. |
| El request nunca aparece en Usage Logs | Cliente, red, base URL o provider mal configurado | Confirma base URL, proxy y selección de provider en la herramienta. |
Usage Logs muestra invalid_api_key | Key o header de auth | Sigue API key inválida. |
Usage Logs muestra model_not_found | Model ID o alcance de modelos de la key | Copia el model ID desde Models y revisa el alcance de la key. |
| Usage Logs muestra error de quota/balance | Billing o presupuesto de key | Revisa Billing y crea una key de reemplazo si el presupuesto es bajo. |
| Un modelo falla pero otro funciona | Upstream específico del modelo o ruteo de modelo | Usa temporalmente el modelo que funciona y reporta ambos model IDs. |
| Todos los modelos hacen timeout desde una red | Red del cliente, proxy, firewall o región | Prueba 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.