Método: models.get
- Extremo
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Ejemplo de solicitud
Obtiene información sobre un modelo específico.
Extremo
obtener
https://generativelanguage.googleapis.com/v1beta/{name=models/*}
Parámetros de ruta
name
string
Obligatorio. El nombre del recurso del modelo.
Este nombre debe coincidir con el nombre de modelo que muestra el método models.list
.
Formato: models/{model}
Toma la forma models/{model}
.
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Ejemplo de solicitud
Python
Una caracola
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Model
.
Método: models.list
- Extremo
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Ejemplo de solicitud
Muestra una lista de los modelos disponibles a través de la API.
Extremo
obtener
https://generativelanguage.googleapis.com/v1beta/models
Parámetros de consulta
pageSize
integer
La cantidad máxima de Models
que se mostrarán (por página).
Es posible que el servicio muestre menos modelos. Si no se especifica, se mostrarán 50 modelos por página como máximo. Este método muestra 1,000 modelos como máximo por página, incluso si pasas un valor de pageSize más grande.
pageToken
string
Un token de página, recibido desde una llamada models.list
anterior.
Proporciona el pageToken
que muestra una solicitud como argumento para la siguiente solicitud a fin de recuperar la página siguiente.
Cuando se pagina, todos los demás parámetros proporcionados a models.list
deben coincidir con la llamada que proporcionó el token de la página.
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Ejemplo de solicitud
Python
Una caracola
Cuerpo de la respuesta
Respuesta de ListModel
que contiene una lista paginada de modelos.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
models[]
object (Model
)
Los modelos devueltos
nextPageToken
string
Un token, que se puede enviar como pageToken
para recuperar la página siguiente.
Si se omite este campo, no habrá más páginas.
Representación JSON |
---|
{
"models": [
{
object ( |
Recurso de REST: models
Recurso: Modelo
Información sobre un modelo de lenguaje generativo.
Representación 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 } |
name
string
Obligatorio. El nombre del recurso de Model
.
Formato: models/{model}
con una convención de nombres {model}
de:
- "{baseModelId}-{version}"
Ejemplos:
models/chat-bison-001
baseModelId
string
Obligatorio. El nombre del modelo base, pasa esto a la solicitud de generación.
Ejemplos:
chat-bison
version
string
Obligatorio. El número de versión del modelo.
Esto representa la versión principal
displayName
string
Es el nombre legible del modelo. P.ej., "Chat Bison".
El nombre puede tener hasta 128 caracteres y puede constar de caracteres UTF-8.
description
string
Una descripción breve del modelo.
inputTokenLimit
integer
La cantidad máxima de tokens de entrada permitidos para este modelo.
outputTokenLimit
integer
Cantidad máxima de tokens de salida disponibles para este modelo.
supportedGenerationMethods[]
string
Los métodos de generación que admite el modelo.
Los nombres de los métodos se definen como cadenas de mayúsculas y minúsculas, como generateMessage
, que corresponden a los métodos de la API.
temperature
number
Controla la aleatorización de la salida.
Los valores pueden variar en [0.0,maxTemperature]
, inclusive. Un valor más alto producirá respuestas más variadas, mientras que un valor más cercano a 0.0
generalmente dará como resultado respuestas menos sorprendentes del modelo. Este valor especifica la configuración predeterminada que usará el backend mientras realiza la llamada al modelo.
maxTemperature
number
La temperatura máxima que puede usar este modelo.
topP
number
Para muestreos de núcleos.
El muestreo de núcleo considera el conjunto más pequeño de tokens cuya suma de probabilidad es al menos topP
. Este valor especifica la configuración predeterminada que usará el backend mientras realiza la llamada al modelo.
topK
integer
Para muestreo de Top-K.
El muestreo de k superior considera el conjunto de topK
tokens más probables. Este valor especifica la configuración predeterminada que usará el backend mientras realiza la llamada al modelo. Si está vacío, indica que el modelo no usa el muestreo de Top-K y que topK
no se permite como parámetro de generación.