查询可用模型 API
GET /v1/models 的两种响应格式、模型 ID 读取,以及模型可见性和实际可调用性的区别。
先查模型,再写请求。GET https://1zheai.com/v1/models 返回当前密钥、分组和模型限制下可见的模型,不需要发送推理请求。
OpenAI 格式
“OpenAI 格式”小节链接curl --fail-with-body --connect-timeout 10 --max-time 30 \ https://1zheai.com/v1/models \ -H "Authorization: Bearer $ONEZHE_API_KEY"下面是精简后的结构示意,列表以实际返回为准:
{ "object": "list", "data": [{"id": "gpt-5.6-sol", "object": "model"}]}安装了 jq 时,可在请求后加 | jq -r '.data[].id',每行显示一个模型 ID。不要把公开价格接口的 model_name 和这里的 id 混淆。
Anthropic 格式
“Anthropic 格式”小节链接使用以下两个请求头时,同一路径返回 Anthropic 风格的数据:
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。切换鉴权方式后,不要继续按另一种响应结构解析。
查询结果怎样使用
“查询结果怎样使用”小节链接- 从
data[].id复制完整 ID,保留大小写、连字符和日期后缀。 - 在控制台模型目录核对该模型的接口类型。
- 用最小文本请求验证,再逐步加上图片、工具或其他参数。
模型列表不是实时健康检查,也不包含所有参数限制。模型可见但暂时没有可用上游时,请求仍可能失败;官网的 HTTP 可用性监控也不等于每个模型都能成功推理。
列表为空或缺少模型
“列表为空或缺少模型”小节链接核对密钥的模型限制与分组;公开价格页展示的模型不一定对每个密钥开放。401 先检查密钥状态,403 检查访问条件;详细步骤见错误码与排错。
模型系列和选择建议见支持的模型。
