GET /v1/models — HHAPI 模型列表接口：查询可用模型 ID 与元数据响应字段说明

GET /v1/models 接口用于查询 HHAPI 当前平台上所有可用模型的列表。返回结果包含每个模型的唯一标识符（id）及基本元数据，适用于在调用对话接口之前动态获取合法的模型 ID，或在界面中展示可选模型供用户选择。

接口信息

请求参数

此接口无必需请求参数，也无可选查询参数，直接携带鉴权头发起请求即可。

以下示例从环境变量读取 API Key 和 Base URL：

curl "$API_BASE_URL/v1/models" \
  -H "Authorization: Bearer $HHAPI_API_KEY"

string

固定值 "list"，表示返回的是一个列表对象。

array

模型对象数组，每个元素代表一个可用模型。

string

模型的唯一标识符，在调用 /v1/chat/completions 等接口时通过 model 字段传入此值。

string

固定值 "model"，表示该对象类型为模型。

integer

模型的创建时间戳（Unix 秒级时间戳）。注意：具体数值待确认，部分模型可能返回占位值 0。

string

模型所属提供方的标识。注意：具体取值待确认，当前可能返回 "hhapi" 或上游提供方名称。

{
  "object": "list",
  "data": [
    {
      "id": "<MODEL_ID>",
      "object": "model",
      "created": 0,
      "owned_by": "hhapi"
    }
  ]
}

状态码	含义	处理建议
`401`	未鉴权或 API Key 无效	检查 `Authorization` 请求头是否正确携带

完整的错误码说明请参阅错误响应说明。

⌘I