借助“models”端点,您可以以编程方式列出可用模型,并检索支持的功能和上下文窗口大小等扩展元数据。如需了解详情,请参阅“模型”指南。
方法:models.get
获取特定 Model
的相关信息,例如其版本号、令牌限制、参数和其他元数据。如需了解详细的模型信息,请参阅 Gemini 模型指南。
端点
gethttps://generativelanguage.googleapis.com/v1beta/{name=models/*}
路径参数
name
string
必需。模型的资源名称。
此名称应与 models.list
方法返回的模型名称一致。
格式:models/{model}
。格式为 models/{model}
。
请求正文
请求正文必须为空。
响应正文
如果成功,则响应正文包含一个 Model
实例。
方法:models.list
列出通过 Gemini API 提供的 Model
。
端点
gethttps://generativelanguage.googleapis.com/v1beta/models
查询参数
pageSize
integer
要返回的 Models
的数量上限(每页)。
如果未指定,则每页会返回 50 个模型。此方法每页最多返回 1, 000 个模型,即使您传递较大的 pageSize 也是如此。
pageToken
string
从之前的 models.list
调用接收的页面令牌。
将一个请求返回的 pageToken
作为下一个请求的参数提供,以检索下一页。
进行分页时,提供给 models.list
的所有其他参数必须与提供页面令牌的调用匹配。
请求正文
请求正文必须为空。
REST 资源:models
资源:Model
生成式语言模型的相关信息。
name
string
必需。Model
的资源名称。如需了解所有允许的值,请参阅模型变体。
格式:models/{model}
,采用以下 {model}
命名规范:
- “{baseModelId}-{version}”
示例:
models/gemini-1.5-flash-001
baseModelId
string
必需。基础模型的名称,将其传递给生成请求。
示例:
gemini-1.5-flash
version
string
必需。模型的版本号。
表示主要版本 (1.0
或 1.5
)
displayName
string
模型的直观易懂的名称。例如“Gemini 1.5 Flash”。
名称不得超过 128 个字符,可以包含任何 UTF-8 字符。
description
string
模型的简短说明。
inputTokenLimit
integer
此模型允许的输入令牌数量上限。
outputTokenLimit
integer
此模型可用的输出令牌数量上限。
supportedGenerationMethods[]
string
模型支持的生成方法。
相应的 API 方法名称定义为 Pascal 大小写形式的字符串,例如 generateMessage
和 generateContent
。
temperature
number
控制输出的随机性。
值的范围介于 [0.0,maxTemperature]
到 [0.0,maxTemperature]
之间(包括这两个数值)。值越高,生成的回答越多样化;而值越接近 0.0
,模型的回答通常就越不出人意料。此值指定后端在调用模型时要使用的默认值。
maxTemperature
number
此模型可以使用的最高温度。
topP
number
适用于 Nucleus 抽样。
核采样会考虑概率总和至少为 topP
的最小一组 token。此值指定后端在调用模型时要使用的默认值。
topK
integer
对于 Top-k 采样。
Top-k 抽样会考虑一组概率最高的 topK
个词元。此值指定后端在调用模型时要使用的默认值。如果为空,表示模型不使用前 k 个样本抽样,并且不允许将 topK
用作生成参数。
JSON 表示法 |
---|
{ "name": string, "baseModelId": string, "version": string, "displayName": string, "description": string, "inputTokenLimit": integer, "outputTokenLimit": integer, "supportedGenerationMethods": [ string ], "temperature": number, "maxTemperature": number, "topP": number, "topK": integer } |