GET /v1/models

Status: Stable public endpoint.

Returns publicly available model IDs through NexoRouter.

Authentication

GET /v1/models requires a valid NexoRouter API key in the Authorization: Bearer header. Anonymous requests receive 401 with invalid_api_key. This matches the gateway security choice for OpenAI-compatible routes: the website Models page is the public browse surface; the Models API is for authenticated integrations.

Endpoint

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

Minimal curl

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

Response shape

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

The response may include additional OpenAI-compatible fields. Use the id field as the stable value for model.

When to call it

Before configuring a new SDK or tool.
During a deployment check.
When debugging model_not_found.
When comparing NexoRouter's public catalog with a local allowlist.