Documentación

Models API en la documentación de NexoRouter.

Models API

Estado: API pública estable.

Usa GET /v1/models para listar model IDs disponibles públicamente. Es la fuente más segura para copiar el valor exacto de model en requests y herramientas.

Página de modelos de NexoRouter

Autenticación

GET /v1/models exige una API key válida de NexoRouter en el encabezado Authorization: Bearer. Las peticiones anónimas reciben 401 con invalid_api_key. Es una decisión de seguridad del gateway: la página Models del sitio es la superficie pública de consulta; la API de Models es para integraciones autenticadas.

Request

curl https://api.nexorouter.com/v1/models \
  -H "Authorization: Bearer $NEXOROUTER_API_KEY"

Cómo elegir un model ID

  1. Abre Models.
  2. Busca por proveedor o capacidad.
  3. Copia el model ID exacto.
  4. Confirma que el modelo esté dentro del alcance de modelos de la API key.
  5. Envía un request pequeño antes de usarlo en producción.

Para qué sirve la API

  • Mantener listas locales de modelos actualizadas.
  • Validar que un model ID existe antes de desplegar.
  • Ayudar a soporte a comparar un model ID del usuario con el catálogo público.

Qué no demuestra

Que un modelo aparezca en la lista pública no prueba que todas las funciones de una herramienta funcionen con ese modelo. Flujos agénticos, tool calling, contexto largo y streaming necesitan verificación específica.

Relacionado