查询模型

本节将介绍如何通过 OpenKey.Cloud 提供的 API 接口来查询当前所支持的模型列表。

查询可用模型

GET /v1/models

1. 查询可用模型 (List Models)

此接口用于获取当前令牌（token）可用的大语言模型列表。

请求

GET /v1/models
Host: https://openkey.cloud
Authorization: Bearer {token}
Content-Type: application/json

请求头（Headers）

Key	Value	描述
Host	https://openkey.cloud	API 服务器地址。
Authorization	Bearer {token}	您的 API 令牌，{token} 需替换。
Content-Type	application/json	请求体格式。

响应

{
  "object": "list",
  "data": [
    {
      "id": "gpt-3.5-turbo",
      "object": "model",
      "created": 1706037600,
      "owned_by": "openkey.cloud"
    },
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1683758102,
      "owned_by": "openkey.cloud"
    },
    {
      "id": "gpt-5",
      "object": "model",
      "created": 1687882411,
      "owned_by": "openkey.cloud"
    }
  ]
}

字段说明

字段	类型	描述
object	string	响应对象的类型，固定为 list。
data	array	包含模型对象的数组。
data.id	string	模型的唯一标识符，可在 API 调用中直接使用。
data.object	string	模型对象的类型，固定为 model。
data.created	integer	模型创建或引入平台的 Unix 秒级时间戳。
data.owned_by	string	模型提供方，此处为 openkey.cloud。

2. 错误码与说明

状态码	说明
401 Unauthorized	鉴权失败或令牌非法。
429 Too Many Requests	超过限流规则。
500 Internal Server Error	服务器内部错误。
400 Bad Request	请求头或参数有误。

3. 限流与使用说明

• 每个令牌每 60 秒最多允许 60 次调用，所有 API 接口共享此限制，超出则返回 429。

• 此接口遵循 OpenAI 的 v1/models 格式，便于客户端兼容。

4. 示例 cURL

查询可用模型

curl -H "Authorization: Bearer sk-XXXX" \
     -H "Content-Type: application/json" \
     https://openkey.cloud/v1/models

5. 注意事项

• 确保 Authorization 请求头中使用的是正确的 Bearer token。

• 返回的模型列表是动态的，可能会随平台更新而增加或调整。建议客户端动态获取此列表。