---
title: "模型列表 API：GET /v1/models"
description: "OpenAI-compatible /v1/models，以及什麼時候應該改用更完整的 /api/models/catalog。"
source: https://lazu.ai/docs/zh-TW/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-TW/models/catalog)。