---
title: "Models list API: GET /v1/models"
description: "OpenAI-compatible /v1/models plus guidance on when to use the richer /api/models/catalog."
source: https://lazu.ai/docs/endpoints/models
updated: 2026-10-02
---

# Models list

**GET** `/v1/models`

List models available to the current API key in the flat OpenAI-compatible shape. For routing, pricing, modality and usage metadata, use /api/models/catalog instead.

## Example request

```bash
curl https://api.lazu.ai/v1/models \
  -H "Authorization: Bearer $LAZU_API_KEY"
```

## Example response

```json
{
  "object": "list",
  "data": [
    { "id": "gpt-6-luna", "object": "model", "owned_by": "openai" },
    { "id": "claude-sonnet-5", "object": "model", "owned_by": "anthropic" }
  ]
}
```

## Which model endpoint should I use?

- **/v1/models** — OpenAI-compatible model list for existing SDKs and tools.
- **/api/models/catalog** — Rich token-scoped catalog for agents, routing, pricing, modalities, endpoint
  support, parameters and usage/cache metadata.

## Response fields

- `object` `string` — Always `list`.
- `data` `object[]` — Accessible model records for the current API key.
- `data[].id` `string` — Model ID.
- `data[].object` `string` — Usually `model`.
- `data[].owned_by` `string` — Provider or owner label.

## Filtering behavior

A model appears here only when:

1. It is enabled on at least one usable Lazu channel.
2. The current API key is allowed to access it.
3. The token's model restrictions do not exclude it.

If an agent needs to choose well, read [Model catalog](https://lazu.ai/docs/models/catalog) first.