GET /v1/models

Estado: Endpoint público estable.

Devuelve model IDs disponibles públicamente mediante 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.

Endpoint

GET https://api.nexorouter.com/v1/models
Authorization: Bearer YOUR_NEXOROUTER_API_KEY

Curl mínimo

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

Forma de response

{
  "object": "list",
  "data": [
    {
      "id": "kimi-k2.6",
      "object": "model"
    }
  ]
}

La respuesta puede incluir campos adicionales compatibles con OpenAI. Usa id como valor estable de model.

Cuándo llamarlo

Antes de configurar un SDK o herramienta.
En un check de despliegue.
Al depurar model_not_found.
Al comparar el catálogo público de NexoRouter con un allowlist local.