接口说明

GET /v1/models 用于获取当前 API Key 可访问的模型列表。你可以用它确认模型 ID 是否可用,也可以在接入工具、模型选择器或后台配置页中动态展示模型。
模型列表可能会随账号权限、模型上下架和服务配置变化。业务侧应以接口实时返回为准,不建议在客户端长期写死模型清单。

请求地址

鉴权

在请求头中传入 API Key:

查询参数

当前接口不需要传查询参数,会返回当前 API Key 可访问的全部模型。
如果业务侧需要按文本、图像、视频、Embedding 等类型展示模型,建议先拉取完整列表,再结合平台模型列表或业务自己的模型分类表进行筛选。不要依赖客户端长期写死模型清单。

cURL 示例

获取全部模型

Python 示例

使用 requests

使用 OpenAI Python SDK

响应示例

响应字段

常见用途

  1. 接入前确认模型 ID 是否存在,例如 deepseek-v4-flashgpt-5.4-minigemini-2.5-flash-image
  2. 在工具配置页里动态拉取模型列表,避免模型上下架后仍展示旧模型。
  3. 配合业务侧模型分类表生成模型选择器,减少客户把文本模型误填到图像、视频或 Embedding 接口的概率。

错误排查