查询可用模型

GET/models

接口说明

使用 Bearer API Key 查询所调用完整地址当前可用的 OpenAI 兼容模型；该查询只鉴权、不计费。

请求

请求地址

方法：GET
鉴权：Authorization: Bearer ${TOKENFACTORY_API_KEY}

请求头

名称	必填	值或类型	说明
`Authorization`	是	`Bearer ${TOKENFACTORY_API_KEY}`	Token Factory API Key

路径参数：无

查询参数：无

请求字段：无

请求报文：无请求体

响应

成功状态：200

响应头

名称	值或类型	说明
`Content-Type`	`application/json`	响应媒体类型
`request-id`	`string`	Token Factory 独立生成的平台请求编号；Anthropic 错误体的 request_id 与其相同。
`retry-after`	`string`	可选重试等待提示：非负秒数或标准 HTTP 日期。重试前仍需确认请求可安全重复。
`x-request-id`	`string`	Token Factory 独立生成的平台请求编号，与 request-id 相同。

响应字段

字段	类型	必填	说明	示例或约束
`data`	`object[]`	是	当前 API Key 在本入口可使用的模型列表。	示例：[{"created":1786665600,"id":"YOUR_MODEL_ID","object":"model","owned_by":"MODE...
`data[].created`	`integer (int64)`	是	已核实模型发布时间的 Unix 秒时间戳。	示例：1786665600
`data[].id`	`string`	是	调用请求中填写的模型 ID。	示例："YOUR_MODEL_ID"
`data[].object`	`string`	是	OpenAI 兼容模型对象类型，固定为 model。	示例："model"；可选值："model"
`data[].owned_by`	`string`	是	OpenAI 兼容所有者标识。	示例："tokenfactory"
`object`	`string`	是	OpenAI 兼容列表对象类型，固定为 list。	示例："list"；可选值："list"

返回报文

媒体类型：application/json

json

{
  "data": [
    {
      "created": 1786665600,
      "id": "YOUR_MODEL_ID",
      "object": "model",
      "owned_by": "MODEL_PROVIDER"
    }
  ],
  "object": "list"
}

错误

适用完整地址	状态	错误码	常见触发	重试	建议动作	结果风险
`https://api.tokenfactory.cn/v1/models`	`401`	`invalid_api_key`	Authorization 缺失、Bearer 格式错误、Key 不可用或账户未实名	否	检查 Bearer API Key、Key 状态与实名状态	无
`https://api.tokenfactory.cn/v1/models`	`500`	`internal_error`	平台内部出现未预期错误	视情况	确认未收到有效结果并记录请求时间后再决定是否重试	中到高
`https://api.tokenfactory.cn/v1/models`	`405`	`method_not_allowed`	请求方法不是该公开地址允许的方法	否	改用文档列出的 HTTP 方法	无

错误返回报文

适用完整地址

https://api.tokenfactory.cn/v1/models

HTTP 401；Content-Type: application/json；响应头：request-id: string、retry-after: string、x-request-id: string

json

{
  "error": {
    "code": "invalid_api_key",
    "message": "Authorization 缺失、Bearer 格式错误、Key 不可用或账户未实名",
    "param": null,
    "type": "authentication_error"
  }
}

限制与计费

适用完整地址	限制或计费说明
`https://api.tokenfactory.cn/v1/models`	只鉴权，不检查或扣减余额。仅返回余额入口可用的 OpenAI 在架模型。

查询可用模型 ​

接口说明 ​

请求 ​

请求头 ​

响应 ​

响应头 ​

响应字段 ​

返回报文 ​

错误 ​

错误返回报文 ​

适用完整地址 ​

限制与计费 ​

相关说明 ​