模型列表

模型列表接口用于获取当前 API 密钥可调用的模型清单。发起查询前，您可以先取得清单，确认要在请求 model 字段中填写的模型名。返回为标准 OpenAI 兼容的模型列表结构，您既有的客户端 SDK 大多可直接调用。

端点

GET /v1/models

列出当前密钥可调用的模型。返回内容已按该子账户在控制台配置的授权范围过滤——清单中列出的模型，即为本密钥可直接填入查询请求 model 字段的模型名。

认证方式与数据平面其余端点一致：请求头携带 API 密钥（Authorization: Bearer <密钥>）。

请求

curl https://<平台入口地址>/v1/models \
  -H "Authorization: Bearer <您的 API 密钥>"

本接口无查询参数；返回范围由密钥自身的授权决定。不同子账户密钥的可用清单可能不同，请以各自密钥的实际返回为准。

响应

返回标准 OpenAI 兼容的 list 结构，data 数组中每一项为一个可调用模型：

{
  "object": "list",
  "data": [
    { "id": "<示例模型-A>", "object": "model" },
    { "id": "<示例模型-B>", "object": "model" },
    { "id": "<示例模型-C>", "object": "model" }
  ]
}

示例仅供说明。 上表中的 <示例模型-A>、<示例模型-B>、<示例模型-C> 为占位示意，用于说明返回形态——实际返回的 id 为平台统一中性名。实际可用的模型清单以本接口的实时返回与控制台「模型」页为准，会随平台模型池的演进而调整。

关于模型名

• 统一中性名。 平台对外一律以统一中性名呈现模型，您无需关心其背后的具体来源与实现。model 字段填写清单中的中性名即可。
• 按密钥授权过滤。 清单只列出当前密钥被授权调用的模型。若查询时填入未在清单内的模型名，平台会返回 403 / 404。请确认 model 取自本接口返回的清单。
• 与统一计价词元的关系。 平台计价口径与模型无关——所有模型的用量统一按统一计价词元的 6 档口径计量与计费，不存在"按模型分别定价"的价目表。因此本接口不返回任何单价信息；具体单价以服务协议价格表与控制台为准。计量口径详见 用量明细与计量说明。

为什么模型列表不带价格。 平台按统一计价词元计量，输入（缓存命中 / 未命中）、输出，各分 thinking 与 no-thinking 档，合计 6 档——计价取决于计量档位而非具体调用了哪个模型。您选择不同模型不会改变计价口径，只影响生成质量与本次落入的档位。这也是统一入口的意义之一：您按需选模型，计费始终一套口径。

在调用中使用模型名

从清单中取得模型名后，直接填入查询请求的 model 字段即可。以对话补全接口为例：

curl https://<平台入口地址>/v1/chat/completions \
  -H "Authorization: Bearer <您的 API 密钥>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<示例模型-A>",
    "messages": [
      { "role": "user", "content": "请帮我归纳这段会议纪要的要点" }
    ],
    "stream": false
  }'

平台会择优路由。 您在 model 中指定的模型是请求的起点；平台会结合本次查询的复杂度研判结果择优转发至最合适的模型，并在异常时自动重试与切换。响应 model 字段返回的是本次实际路由的模型名，可能与请求中填写的不同——这是智能查询路由聚合的正常表现。

注意事项

• 以实时返回为准。 可用模型清单会随平台模型池演进而调整；请勿将某一时点的清单硬编码到应用中，建议按需查询或定期刷新。
• 新增模型无需改造接入。 平台新增可用模型时，会出现在本接口返回中，您按中性名填入即可使用，接入方式与计价口径不变。
• 控制台同源。 控制台「模型」页展示的可用清单与本接口同源，便于您在控制台核对授权范围。

相关链接

本页示例模型名仅为说明，实际可用模型以接口实时返回与控制台为准；平台计价与模型无关，具体单价以服务协议与控制台实时口径为准。