> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Models API：获取模型 ID 列表

> 用 GET /v1/models 获取当前老张API密钥可见的模型 ID，附 cURL 与 Python 示例和响应格式，并说明价格、端点与分组该去哪里确认。

Models API 返回当前 API Key 可见的模型 ID 列表，响应格式与 OpenAI Models API 的 list 方法相同。

| 项目 | 内容 |
| - | - |
| 端点 | `GET https://api.laozhang.ai/v1/models` |
| 返回内容 | 只说明模型 ID 可见，不含价格 |
| 端点、价格与分组 | 以[模型与价格总表](/models)和[控制台](https://api.laozhang.ai/account/pricing)为准 |

## 获取模型列表

请求使用 `Authorization: Bearer` 认证。先在[令牌管理](https://api.laozhang.ai/token)创建 API Key 并写入环境变量；使用 Python 示例时，再执行 `python -m pip install openai`。

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的老张API密钥"
```

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl --fail-with-body --max-time 60 \
      "https://api.laozhang.ai/v1/models" \
      -H "Authorization: Bearer $LAOZHANG_API_KEY"
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import os
    from openai import OpenAI

    client = OpenAI(
        api_key=os.environ["LAOZHANG_API_KEY"],
        base_url="https://api.laozhang.ai/v1",
        timeout=60.0,
    )
    model_ids = sorted(model.id for model in client.models.list())
    print(f"共 {len(model_ids)} 个模型")
    print("\n".join(model_ids))

    target = "gpt-5.4-mini"
    print(f"{target} 可见" if target in model_ids else f"{target} 不在列表中")
    ```
  </Tab>
</Tabs>

## 响应格式

响应是 OpenAI 格式的列表对象，`data` 中每一项是一个模型：

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4-mini",
      "object": "model",
      "created": 1626777600,
      "owned_by": "openai"
    }
  ]
}
```

`id` 是调用时填写的模型 ID。上例中 `created` 和 `owned_by` 是示例值，这两个字段不代表模型的上线日期或实际上游，程序不要依赖。实际响应可能包含更多字段，解析时忽略不认识的字段即可。

## 常见问题

### Models API 会返回价格吗？

不会。响应只包含模型 ID 等基础信息。价格、计费方式和可用分组查看[模型与价格总表](/models)，实际扣费以[调用日志](/faq/call-logs)为准。

### 列表有该模型，为何调用返回 403 或 404？

列表只说明模型 ID 可见，不说明它支持你正在调用的接口。先在[模型与价格总表](/models)核对该模型的「兼容端点」与请求路径是否一致，再确认 API Key 所在令牌分组有调用权限。完整排查步骤见[模型可用性与权限](/faq/model-availability)。

### 控制台能看到模型，为什么列表里没有？

列表按请求所用的 API Key 返回。确认发请求的是哪一把 Key，以及它的令牌分组是否包含这个模型；分组在[令牌管理](https://api.laozhang.ai/token)中查看。

调整分组或换用正确的 Key 后重新请求；仍不一致时，把请求时间、模型 ID 和分组名发给支持团队。

## 相关文档

* [OpenAI 官方 List models 参考](https://developers.openai.com/api/reference/resources/models/methods/list)
* [模型与价格总表](/models)
* [模型可用性与权限](/faq/model-availability)
* [OpenAI 协议](/api-reference/chat-completions)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.