跳转到内容
Русский

查询可用模型 API

GET /v1/models 的两种响应格式、模型 ID 读取,以及模型可见性和实际可调用性的区别。

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

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 风格的数据:

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. 在控制台模型目录核对该模型的接口类型。
  3. 用最小文本请求验证,再逐步加上图片、工具或其他参数。

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

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

模型系列和选择建议见支持的模型。