---
title: "模型列表 API：GET /v1/models"
description: "OpenAI-compatible /v1/models，以及什么时候应该改用更完整的 /api/models/catalog。"
source: https://lazu.ai/docs/zh/endpoints/models
updated: 2026-10-02
---

# 模型列表

**GET** `/v1/models`

以扁平 OpenAI-compatible shape 列出当前 API Key 可访问的模型。需要路由、价格、模态和 usage metadata 时，请使用 /api/models/catalog。

## 请求示例

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

## 响应示例

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

## 应该使用哪个模型 endpoint？

- **/v1/models** — 面向现有 SDK 和工具的 OpenAI-compatible 模型列表。
- **/api/models/catalog** — 面向 agent、路由、计费、模态、endpoint 支持、参数和 usage/cache metadata
  的完整目录。

## 响应字段

- `object` `string` — 始终为 `list`。
- `data` `object[]` — 当前 API Key 可访问的模型记录。
- `data[].id` `string` — 模型 ID。
- `data[].object` `string` — 通常为 `model`。
- `data[].owned_by` `string` — provider 或 owner 标签。

## 过滤行为

模型只会在满足以下条件时出现在这里：

1. 至少有一个可用 Lazu channel 启用了该模型。
2. 当前 API Key 被允许访问该模型。
3. Token 的模型限制没有排除该模型。

如果 agent 需要做可靠选择，请优先读取 [模型目录](https://lazu.ai/docs/zh/models/catalog)。