接口说明
GET /v1/models 用于获取当前 API Key 可访问的模型列表。你可以用它确认模型 ID 是否可用,也可以在接入工具、模型选择器或后台配置页中动态展示模型。
模型列表可能会随账号权限、模型上下架和服务配置变化。业务侧应以接口实时返回为准,不建议在客户端长期写死模型清单。
请求地址
鉴权
在请求头中传入 API Key:查询参数
当前接口不需要传查询参数,会返回当前 API Key 可访问的全部模型。cURL 示例
获取全部模型
Python 示例
使用 requests
使用 OpenAI Python SDK
响应示例
响应字段
常见用途
- 接入前确认模型 ID 是否存在,例如
deepseek-v4-flash、gpt-5.4-mini、gemini-2.5-flash-image。 - 在工具配置页里动态拉取模型列表,避免模型上下架后仍展示旧模型。
- 配合业务侧模型分类表生成模型选择器,减少客户把文本模型误填到图像、视频或 Embedding 接口的概率。