Models

El extremo de modelos te permite enumerar de forma programática los modelos disponibles y recuperar metadatos extendidos, como la funcionalidad compatible y el tamaño de la ventana de contexto. Obtén más información en la guía de modelos.

Método: models.get

Obtiene información sobre un Model específico, como su número de versión, límites de tokens, parámetros y otros metadatos. Consulta la guía de modelos de Gemini para obtener información detallada sobre el modelo.

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

model_info = genai.get_model("models/gemini-1.5-flash-latest")
print(model_info)
models.py

Una caracola

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash?key=$GOOGLE_API_KEY
models.sh

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Model.

Método: models.list

Enumera las Model disponibles a través de la API de Gemini.

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).

Si no se especifica, se mostrarán 50 modelos por página. 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

print("List of models that support generateContent:\n")
for m in genai.list_models():
    if "generateContent" in m.supported_generation_methods:
        print(m.name)

print("List of models that support embedContent:\n")
for m in genai.list_models():
    if "embedContent" in m.supported_generation_methods:
        print(m.name)
models.py

Una caracola

curl https://generativelanguage.googleapis.com/v1beta/models?key=$GOOGLE_API_KEY
models.sh

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:

Campos
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 (Model)
    }
  ],
  "nextPageToken": string
}

Recurso de REST: models

Recurso: Modelo

Información sobre un modelo de lenguaje generativo.

Campos
name string

Obligatorio. El nombre del recurso de Model. Consulta Variantes del modelo para conocer todos los valores permitidos.

Formato: models/{model} con una convención de nombres {model} de:

  • “{baseModelId}-{version}”

Ejemplos:

  • models/gemini-1.5-flash-001
baseModelId string

Obligatorio. El nombre del modelo base, pasa esto a la solicitud de generación.

Ejemplos:

  • gemini-1.5-flash
version string

Obligatorio. El número de versión del modelo.

Representa la versión principal (1.0 o 1.5).

displayName string

Es el nombre del modelo legible por humanos. P.ej., “Gemini 1.5 Flash”.

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 método de API correspondientes se definen como strings en mayúsculas y minúsculas, como generateMessage y generateContent.

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 Muestreo basado en 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.

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
}