---
title: 查询可用模型 API
description: GET /v1/models 的两种响应格式、模型 ID 读取，以及模型可见性和实际可调用性的区别。
---

<aside className="docs-publication" data-pagefind-ignore>

文档由 [1折AI](https://1zheai.com/editorial/#publisher) 维护。[来源与纠错说明](https://1zheai.com/editorial/)。

发现错误？[联系支持](mailto:support@1zheai.com)，请附页面地址和问题说明。不要发送密钥或账号资料。

</aside>

先查模型，再写请求。`GET https://1zheai.com/v1/models` 返回当前密钥、分组和模型限制下可见的模型，不需要发送推理请求。

## OpenAI 格式

```bash
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  https://1zheai.com/v1/models \
  -H "Authorization: Bearer $ONEZHE_API_KEY"
```

下面是精简后的结构示意，列表以实际返回为准：

```json
{
  "object": "list",
  "data": [{"id": "gpt-5.6-sol", "object": "model"}]
}
```

安装了 `jq` 时，可在请求后加 `| jq -r '.data[].id'`，每行显示一个模型 ID。不要把公开价格接口的 `model_name` 和这里的 `id` 混淆。

## Anthropic 格式

使用以下两个请求头时，同一路径返回 Anthropic 风格的数据：

```bash
curl --fail-with-body https://1zheai.com/v1/models \
  -H "x-api-key: $ONEZHE_API_KEY" \
  -H "anthropic-version: 2023-06-01"
```

关注 `data[].id`、`data[].display_name` 和 `has_more`。切换鉴权方式后，不要继续按另一种响应结构解析。

## 查询结果怎样使用

1. 从 `data[].id` 复制完整 ID，保留大小写、连字符和日期后缀。
2. 在[控制台模型目录](https://1zheai.com/model-catalog)核对该模型的接口类型。
3. 用最小文本请求验证，再逐步加上图片、工具或其他参数。

模型列表不是实时健康检查，也不包含所有参数限制。模型可见但暂时没有可用上游时，请求仍可能失败；官网的 HTTP 可用性监控也不等于每个模型都能成功推理。

## 列表为空或缺少模型

核对密钥的模型限制与分组；公开价格页展示的模型不一定对每个密钥开放。401 先检查密钥状态，403 检查访问条件；详细步骤见[错误码与排错](/docs/troubleshooting/)。

模型系列和选择建议见[支持的模型](/docs/models/)。