Documentación
Manejo de errores en la documentación de NexoRouter.
Manejo de errores
Estado: Guía pública estable.
NexoRouter devuelve errores JSON estilo OpenAI para endpoints públicos documentados. Empieza por error.code y luego usa Usage Logs para confirmar key, modelo y request ID.
Códigos comunes
| Código | Causa típica | Primera corrección |
|---|---|---|
invalid_request | Body mal formado o parámetro fuera de rango. | Revisa JSON, messages, max_tokens, temperature y top_p. |
invalid_api_key | Key ausente, incorrecta, expirada, deshabilitada o de otro servicio. | Recrea o revela la key correcta. |
model_not_found | Typo de model ID o alcance de modelos. | Copia el model ID exacto desde Models. |
insufficient_quota | Saldo o presupuesto de key insuficiente. | Recarga saldo o crea una key nueva con el presupuesto correcto. |
rate_limit_exceeded | Volumen de requests excedido. | Espera y baja concurrencia. |
request_too_large | Request demasiado grande. | Divide el input. |
upstream_request_timeout | El proveedor no completó a tiempo. | Sube timeout o prueba otro modelo. |
Handoff a soporte
Al contactar soporte, incluye:
- request ID
- timestamp
- nombre de API key, no el valor secreto
- model ID
- endpoint
- forma del body sin datos sensibles
- código de error observado