模型列表
查询当前对外可用的 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",
"name": "gpt-image-2",
"region": "all",
"family": "image",
"description": "通用图片生成",
"capabilities": ["image_generation"],
"pricing": {"unit": "image", "display": "按图片计费", "credits_text": "以 /v1/quote 为准"},
"schema": {"fields": [{"name": "resolution", "type": "string", "required": false, "default": "1K", "options": ["1K", "2K", "4K"]}]},
"ui_hints": [],
"enabled": true
}
]
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
object | string | 列表对象类型，通常为 list |
data | array | 当前可用模型列表 |
data[].id | string | 模型 ID，后续调用时直接传给 model |
data[].family | string | 模型类型；当前文档只说明已对外开放的 image 和 video 调用流程 |
data[].schema.fields | array | 动态参数定义，包含字段名、类型、是否必填、默认值、枚举 options 和限制 |
data[].pricing | object | 计费展示信息；准确积分以 /v1/quote 为准 |
data[].enabled | boolean | 当前是否启用 |
接入建议
- 模型是否支持图片或视频参数，不要只靠名字硬编码判断，优先读取
family和schema.fields - 当前没有公开的
/v1/models/{model}/schema，模型参数直接从列表项的schema.fields读取 - 图片和视频模型的参数差异，统一看 支持模型与参数
- 如果你的前端要动态显示模型列表，建议定期刷新而不是写死