OpenAI API Models 接口参考
Models 资源用于查询可用模型及其元数据,也提供删除微调模型的操作。
接口一览
删除微调模型
DELETE /v1/models/{model}
删除指定的微调模型。调用者须在组织中具有 Owner(所有者)角色。
路径参数
| 字段 | 类型 | 说明 |
|---|---|---|
model |
string |
要删除的模型 ID。 |
响应
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string |
已删除的模型 ID。 |
deleted |
boolean |
是否已删除。 |
object |
string |
返回对象类型。 |
请求示例
## 先设置 OPENAI_API_KEY 和 MODEL_ID。
curl -X DELETE "https://api.openai.com/v1/models/$MODEL_ID" \
-H "Authorization: Bearer $OPENAI_API_KEY"
响应示例
{
"id": "ft:example-model:example-org:demo:123",
"object": "model",
"deleted": true
}
列出可用模型
GET /v1/models
列出当前可用的模型及其所有者等基本信息。
响应
| 字段 | 类型 | 说明 |
|---|---|---|
data |
array of Model |
可用模型数组,每项的字段如下。 |
object |
"list" |
列表对象类型,固定为 list。 |
模型对象
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string |
可在其他 API 请求中使用的模型 ID。 |
created |
integer |
模型创建时间,Unix 时间戳,单位为秒。 |
object |
"model" |
对象类型,固定为 model。 |
owned_by |
string |
拥有模型的组织。 |
shutdown_date |
string,可选,可为 null |
模型停用日期,格式为 YYYY-MM-DD。若未宣布停用日期,可返回 null。 |
请求示例
## 先设置 OPENAI_API_KEY。
curl "https://api.openai.com/v1/models" \
-H "Authorization: Bearer $OPENAI_API_KEY"
响应示例
{
"data": [
{
"id": "example-model",
"object": "model",
"created": 1735689600,
"owned_by": "example-organization",
"shutdown_date": null
}
],
"object": "list"
}
获取指定模型
GET /v1/models/{model}
按模型 ID 查询单个模型的基本信息,包括所有者等。
路径参数
| 字段 | 类型 | 说明 |
|---|---|---|
model |
string |
要查询的模型 ID。 |
响应
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string |
可在其他 API 请求中使用的模型 ID。 |
created |
integer |
模型创建时间,Unix 时间戳,单位为秒。 |
object |
"model" |
对象类型,固定为 model。 |
owned_by |
string |
拥有模型的组织。 |
shutdown_date |
string,可选,可为 null |
模型停用日期,格式为 YYYY-MM-DD。若未宣布停用日期,可返回 null。 |
请求示例
## 先设置 OPENAI_API_KEY 和 MODEL_ID。
curl "https://api.openai.com/v1/models/$MODEL_ID" \
-H "Authorization: Bearer $OPENAI_API_KEY"
响应示例
{
"id": "example-model",
"object": "model",
"created": 1735689600,
"owned_by": "example-organization",
"shutdown_date": null
}