什么是模型列表?
模型列表展示了您的 API Key 可以使用的所有 AI 模型。每个 API Key 根据其分组配置可以访问不同的模型。在进行 API 调用之前,您应始终检查哪些模型可用。只有为您的 API Key 分组启用的模型才会出现在列表中。如果您没有看到预期的模型,请联系管理员或查看限制与前提条件。
如何获取模型列表
您可以通过发送一个简单的 GET 请求来获取可用模型列表。使用的端点取决于您想使用的协议。OpenAI 兼容模型
如果您使用 OpenAI 风格的请求,请使用此端点:Claude 模型
使用此端点获取 Claude 模型:Gemini 模型
使用此端点获取 Gemini 模型:理解响应内容
响应将包含一个模型列表。每个模型包含以下重要信息:id:模型标识符——在 API 请求中使用此精确值owned_by:模型的来源或提供商- 定价信息:每个 token 或请求的费用(仅供展示)
- 其他元数据:关于模型的其他信息
模型列表中的定价信息仅供参考。实际计费根据您的用量计算。详情请参阅查看用量与计费。
示例响应
何时检查模型列表
- 首次进行 API 调用之前:确保您想使用的模型可用
- 遇到错误时:如果模型未找到,请检查它是否在您的可用列表中
- 构建 UI 时:使用模型列表来填充下拉菜单或模型选择器
- 配置变更后:如果管理员更改了您的分组设置,请重新检查列表
重要说明
- 模型可用性:只有为您的 API Key 分组启用的模型才会出现。不同的 API Key 可能看到不同的模型。
-
模型名称:请始终在 API 请求中使用模型列表中的精确
id。模型名称区分大小写。 - 实时更新:列表反映当前状态。如果模型被启用或禁用,您可能需要刷新列表。
- 定价:模型列表中显示的定价仅供参考。实际计费根据您的实际用量计算。