切换外观
查询 OpenAI 模型详情
GET/models/{model}- 鉴权
- Bearer API Key
- 执行方式
- 按所调用的完整地址执行
接口说明
本页说明查询 OpenAI 模型详情能力的共同请求与响应结构，各地址的权益、错误与限制按完整公开地址分别列出。
请求
以下请求头、参数与报文结构适用于本页列出的全部完整公开地址。
方法：
GET鉴权：
Authorization: Bearer ${TOKENFACTORY_API_KEY}
请求头
| 名称 | 必填 | 值或类型 | 说明 |
|---|---|---|---|
Authorization | 是 | Bearer ${TOKENFACTORY_API_KEY} | Token Factory API Key |
路径参数
| 名称 | 必填 | 类型 | 说明 | 示例或约束 |
|---|---|---|---|---|
model | 是 | string | 要查询的 canonical 模型 ID 或受控别名。 | — |
查询参数：无
请求字段：无
请求报文：无请求体
响应
成功状态：200
响应头
| 名称 | 值或类型 | 说明 |
|---|---|---|
Content-Type | application/json | 响应媒体类型 |
响应字段
| 字段 | 类型 | 必填 | 说明 | 示例或约束 |
|---|---|---|---|---|
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}https://api.tokenfactory.cn/v1/coding/models/{model} | 401 | invalid_api_key | Authorization 缺失、Bearer 格式错误、Key 不可用或账户未实名 | 否 | 检查 Bearer API Key、Key 状态与实名状态 | 无 |
https://api.tokenfactory.cn/v1/models/{model}https://api.tokenfactory.cn/v1/coding/models/{model} | 404 | model_not_found | 模型不存在、未上架或当前入口不可用 | 否 | 调用模型列表并改用当前入口可用模型 | 无 |
https://api.tokenfactory.cn/v1/models/{model}https://api.tokenfactory.cn/v1/coding/models/{model} | 500 | internal_error | 平台内部出现未预期错误 | 视情况 | 确认未收到有效结果并记录请求时间后再决定是否重试 | 中到高 |
错误返回报文
适用完整地址
https://api.tokenfactory.cn/v1/models/{model}、https://api.tokenfactory.cn/v1/coding/models/{model}
HTTP 401；Content-Type: application/json
json
{
"error": {
"code": "invalid_api_key",
"message": "Authorization 缺失、Bearer 格式错误、Key 不可用或账户未实名",
"type": "authentication_error"
}
}限制与计费
| 适用完整地址 | 限制或计费说明 |
|---|---|
https://api.tokenfactory.cn/v1/models/{model} | 只鉴权，不检查或扣减余额。 支持 canonical ID 或受控别名；响应始终返回 canonical ID。 余额计费调用不会自动改用 Coding Plan 权益。 |
https://api.tokenfactory.cn/v1/coding/models/{model} | 只鉴权，不预留套餐、不计入用量。 仅返回当前有效 Coding Plan 与 OpenAI Surface 共同可见的模型。 Coding Plan 权益独立核验；套餐不可用时不会自动改扣余额。 |
调用示例
cURL · https://api.tokenfactory.cn/v1/models/{model}
sh
curl --request GET "https://api.tokenfactory.cn/v1/models/${TOKENFACTORY_MODEL_ID}" --silent --show-error --fail-with-body --max-time 60 --header "Authorization: Bearer ${TOKENFACTORY_API_KEY}"cURL · https://api.tokenfactory.cn/v1/coding/models/{model}
sh
curl --request GET "https://api.tokenfactory.cn/v1/coding/models/${TOKENFACTORY_MODEL_ID}" --silent --show-error --fail-with-body --max-time 60 --header "Authorization: Bearer ${TOKENFACTORY_API_KEY}"相关说明
这是平台模型详情查询；只鉴权、不计费，支持 canonical ID 或受控别名作为查询输入，响应始终返回 canonical ID。