GET/v1/models

查询可用模型

该接口由平台兼容 OpenAI 风格返回 `object=list` 与 `data[]`。模型结果同时受网关鉴权与平台模型启用状态限制。

基础信息

鉴权	Authorization: Bearer sk-...
请求类型	none
响应类型	application/json

请求参数

该接口没有额外请求参数。

响应示例

json

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1744512000,
      "owned_by": "openai"
    },
    {
      "id": "sora-2",
      "object": "model",
      "created": 1744512000,
      "owned_by": "video"
    }
  ]
}

错误码

HTTP	code	说明
400	`invalid_request_error`	请求体结构不合法、缺少必填参数，或 JSON 无法解析。
401	`invalid_auth_header`	缺少或传错鉴权头，网关无法识别当前调用身份。
403	`model_not_allowed`	当前 API Key 没有访问该模型的权限。
402	`insufficient_balance`	余额不足，平台在调用前预检时已拒绝请求。
503	`model_not_available`	当前模型没有可用路由或上游渠道不可用。

在线调试

Playground · 浏览器直连网关

查询可用模型

返回当前 API Key 有权访问的模型列表。

Base URL Token / API Key

json

尚未发起请求。

bash

curl --location --request GET 'https://api.harnmodel.com/v1/models' \
  --header 'Authorization: Bearer sk-xxx'

多语言示例

bash

curl --location --request GET 'https://api.harnmodel.com/v1/models' \
  --header 'Authorization: Bearer sk-xxx'