获取模型列表
概览
接入规则
鉴权方式
路径规则
GET /v1/modelsGET /v1beta/modelsGET /v1/modelsGET /v1beta/models通用调用方式
GET 请求，无需请求体。model 参数。能力清单
| 能力名称 | 是否支持 | 说明 |
|---|---|---|
| OpenAI / Anthropic 格式 | ✔️ | 返回 object + data[] 结构的模型列表 |
| Gemini 格式 | ✔️ | 返回 models[] 结构的模型列表 |
接口详情
https://api.onelinkai.cloud 作为示例网关地址，实际调用时请替换为你的真实接入地址和有效的 ApiKey。OpenAI / Anthropic 格式
GET /v1/modelsGETobject、data[].id、data[].object、data[].created、data[].owned_by、data[].descriptiondata[].id 可直接在后续接口调用中作为 model 参数使用响应体
{
"object": "list",
"data": [
{
"id": "gpt-4.1",
"object": "model",
"created": 1713833628,
"owned_by": "onelinkai",
"description": "通用文本生成模型"
}
]
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| object | string | 返回对象类型，通常为 list |
| data | array | 模型列表数组 |
| data[].id | string | 模型 ID，可在后续调用中作为 model 参数使用 |
| data[].object | string | 对象类型，通常为 model |
| data[].created | integer | 模型创建时间，Unix 时间戳（秒） |
| data[].owned_by | string | 模型所属提供方或组织 |
| data[].description | string | 模型描述信息，用于说明模型能力或用途 |
请求示例
Gemini 格式
GET /v1beta/modelsGETmodels[].name、models[].displayName、models[].supportedGenerationMethods、models[].descriptionmodels[].name 通常形如 models/{model}，适合 Gemini 风格客户端直接使用响应体
{
"models": [
{
"name": "models/gemini-2.5-flash",
"displayName": "Gemini 2.5 Flash",
"supportedGenerationMethods": [
"generateContent",
"streamGenerateContent"
],
"description": "轻量级多模态生成模型"
}
]
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| models | array | 模型列表数组 |
| models[].name | string | 模型资源名称，通常形如 models/{model} |
| models[].displayName | string | 模型的人类可读名称 |
| models[].supportedGenerationMethods | array | 该模型支持的生成方法列表，例如 generateContent、streamGenerateContent |
| models[].description | string | 模型描述信息，用于说明模型能力或用途 |
请求示例
使用建议
GET /v1/models。GET /v1beta/models。修改于 2026-05-29 06:43:05