Documentación
Modelos y Model IDs en la documentación de NexoRouter.
Modelos y Model IDs
La página Models es la fuente de verdad para model IDs públicos. Úsala al llamar la API, configurar herramientas y resolver model_not_found.
Buenos modelos iniciales
| Necesidad | Empieza con | Por qué |
|---|---|---|
| Pruebas de bajo costo | deepseek-v4-flash | Checks rápidos de API, automatización y loops de agentes. |
| Funciones generales | gpt-4o-mini | Generación de texto, extracción, soporte y reasoning ligero. |
| Workflows multilingües | Qwen/Qwen-Plus | Generación equilibrada en inglés, español y chino. |
Copia el model ID exacto
Los model IDs distinguen mayúsculas. Barras y sufijos importan.
Correcto:
Qwen/Qwen-Plus
IDs diferentes:
qwen-plus
Qwen Plus
qwen/qwen-plus
Estado público de modelos
El sitio usa estos estados:
| Estado | Significado |
|---|---|
Available | Vendible públicamente y usable por API. |
Price pending | Visible por transparencia de catálogo, pero no vendible públicamente hasta confirmar precio. |
Tiered | Modelo público con precio complejo o por niveles normalizado para display. |
Unavailable | No disponible upstream actualmente. |
Solo modelos disponibles públicamente aparecen en GET /v1/models.
Alcance de modelos de API key
Una API key puede estar:
- sin restricción, lo que permite usar modelos disponibles públicamente actuales y futuros;
- limitada a modelos chat;
- limitada a model IDs seleccionados.
Si el alcance de una key es demasiado estrecho, un request puede devolver model_not_found incluso cuando el modelo existe en el catálogo público.
Resolver model_not_found
- Abre Models.
- Busca el modelo.
- Copia el model ID completo.
- Confirma que el alcance de la key permite ese modelo.
- Reintenta el request.
No copies aliases directamente desde documentación de otro proveedor. Los model IDs públicos de NexoRouter pueden diferir de los aliases upstream.