Documentación
FAQ: ¿Cómo funcionan versiones y alias de modelos? en la documentación de NexoRouter.
FAQ: ¿Cómo funcionan versiones y alias de modelos?
Usa el model ID público exacto que muestra NexoRouter. Alias de proveedor, nombres comerciales y nombres antiguos pueden no coincidir con el ID aceptado por la API pública.
Regla segura
Usa model IDs desde Models o GET /v1/models.No copies nombres de modelo directamente desde el dashboard de otro proveedor salvo que el mismo ID aparezca en NexoRouter Models.
Por qué difieren los nombres
| Tipo de nombre | Riesgo |
|---|---|
| Nombre comercial | Puede omitir versión, proveedor o sufijo. |
| Alias upstream | Puede no estar expuesto por NexoRouter. |
| Captura antigua | Puede referirse a un modelo retirado o renombrado. |
| Texto sin distinguir mayúsculas | El model ID de la API distingue mayúsculas y minúsculas. |
Práctica de producción
- Mantén model IDs en config.
- Revisa model IDs antes del rollout.
- Usa un modelo fallback para tareas no críticas.
- Monitorea Usage Logs por
model_not_found. - Evita alias no documentados en producción.