查询 OpenAI 模型详情

GET/models/{model}

接口说明

使用 Bearer API Key 按 canonical ID 或受控别名查询余额入口可用的 OpenAI 兼容模型；响应始终返回 canonical ID 和已核实发布时间。

请求

请求地址

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

请求头

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

路径参数

名称	必填	类型	说明	示例或约束
`model`	是	`string`	要查询的 canonical 模型 ID 或受控别名。	—

查询参数：无

请求字段：无

请求报文：无请求体

响应

成功状态：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 相同。

响应字段

字段	类型	必填	说明	示例或约束
`created`	`integer (int64)`	是	已核实模型发布时间的 Unix 秒时间戳。	示例：1786665600
`id`	`string`	是	调用请求中填写的模型 ID。	示例："YOUR_MODEL_ID"
`object`	`string`	是	OpenAI 兼容模型对象类型，固定为 model。	示例："model"；可选值："model"
`owned_by`	`string`	是	OpenAI 兼容所有者标识。	示例："tokenfactory"

返回报文

媒体类型：application/json

json

{
  "created": 1786665600,
  "id": "YOUR_MODEL_ID",
  "object": "model",
  "owned_by": "MODEL_PROVIDER"
}

错误

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

错误返回报文

适用完整地址

https://api.tokenfactory.cn/v1/models/{model}

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/{model}`	只鉴权，不检查或扣减余额。支持 canonical ID 或受控别名；响应始终返回 canonical ID。

查询 OpenAI 模型详情 ​

接口说明 ​

请求 ​

请求头 ​

路径参数 ​

响应 ​

响应头 ​

响应字段 ​

返回报文 ​

错误 ​

错误返回报文 ​

适用完整地址 ​

限制与计费 ​

相关说明 ​