模型列表
查询当前对外可用的 OpenAI 兼容模型列表，适合作为接入前的模型探测接口。
这是开发者接入时最常调用的只读接口之一。
GET /v1/models接口概览
| 项 | 说明 |
|---|---|
| 路由 | GET /v1/models |
| 鉴权 | Authorization: Bearer sk_yeehoo_xxx |
| 请求体 | 无 |
| 返回 | 200 OK + 模型列表 |
适用场景
- 初始化时拉取当前可用模型
- 检查某个环境是否已开放目标模型
- 给你自己的后台或配置页做模型下拉列表
Authorizations
Authorization: Bearer sk_yeehoo_your_api_keyResponse
成功时通常返回模型列表对象。
{
"object": "list",
"data": [
{
"id": "gpt-image-2",
"object": "model",
"owned_by": "yeehoo"
}
]
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
object | string | 列表对象类型，通常为 list |
data | array | 当前可用模型列表 |
data[].id | string | 模型 ID，后续调用时直接传给 model |
data[].object | string | 模型对象类型 |
data[].owned_by | string | 模型归属标识 |
接入建议
- 模型是否支持图片或视频参数，不要只靠名字硬编码判断
- 图片和视频模型的参数差异，统一看 支持模型与参数
- 如果你的前端要动态显示模型列表，建议定期刷新而不是写死