Models

Конечная точка моделей предоставляет вам возможность программно перечислить доступные модели и получить расширенные метаданные, такие как поддерживаемые функции и размеры контекстного окна. Подробнее читайте в руководстве по моделям .

Метод: models.get

Получает информацию о конкретной Model , такую ​​как номер версии, ограничения токенов, параметры и другие метаданные. Подробную информацию о модели см. в руководстве по моделям Gemini .

Конечная точка

получить https: / /generativelanguage.googleapis.com /v1beta /{name=models /*}

Параметры пути

name string

Обязательно. Имя ресурса модели.

Это имя должно совпадать с именем модели, возвращаемым методом models.list .

Формат: models/{model} Принимает форму models/{model} .

Текст запроса

Тело запроса должно быть пустым.

Пример запроса

Питон 

from google import genai

client = genai.Client()
model_info = client.models.get(model="gemini-2.0-flash")
print(model_info)
models.py

Оболочка 

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

Тело ответа

В случае успеха тело ответа содержит экземпляр Model .

Метод: models.list

Перечисляет Model , доступные через API Gemini.

Конечная точка

получить https: / /generativelanguage.googleapis.com /v1beta /models

Параметры запроса

pageSize integer

Максимальное количество возвращаемых Models (на страницу).

Если не указано, будет возвращено 50 моделей на страницу. Этот метод возвращает максимум 1000 моделей на страницу, даже если вы передадите больший pageSize.

string pageToken

Токен страницы, полученный от предыдущего вызова models.list .

Предоставьте pageToken , возвращенный одним запросом, в качестве аргумента следующему запросу для получения следующей страницы.

При разбиении на страницы все остальные параметры, предоставленные models.list должны соответствовать вызову, предоставившем токен страницы.

Текст запроса

Тело запроса должно быть пустым.

Пример запроса

Питон 

from google import genai

client = genai.Client()

print("List of models that support generateContent:\n")
for m in client.models.list():
    for action in m.supported_actions:
        if action == "generateContent":
            print(m.name)

print("List of models that support embedContent:\n")
for m in client.models.list():
    for action in m.supported_actions:
        if action == "embedContent":
            print(m.name)
models.py

Оболочка 

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

Тело ответа

Ответ от ListModel , содержащий постраничный список моделей.

В случае успеха тело ответа содержит данные со следующей структурой:

Поля
models[] object ( Model )

Возвращенные модели.

string nextPageToken

Токен, который можно отправить как pageToken для получения следующей страницы.

Если это поле пропущено, страниц больше нет.

JSON-представление 
{
  "models": [
    {
      object (Model)
    }
  ],
  "nextPageToken": string
}

Ресурс REST: модели

Ресурс: Модель

Информация о модели генеративного языка.

Поля
name string

Обязательно. Имя ресурса Model . Все допустимые значения см. в разделе Варианты модели .

Формат: models/{model} с соглашением об именовании {model} :

  • "{baseModelId}-{version}"

Примеры:

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

Обязательно. Имя базовой модели, передайте его в запрос на генерацию.

Примеры:

  • gemini-1.5-flash
string version

Обязательно. Номер версии модели.

Это представляет основную версию ( 1.0 или 1.5 )

displayName string

Удобочитаемое название модели. Например, «Gemini 1.5 Flash».

Имя может иметь длину до 128 символов и может состоять из любых символов UTF-8.

string description

Краткое описание модели.

inputTokenLimit integer

Максимальное количество входных токенов, разрешенное для этой модели.

outputTokenLimit integer

Максимальное количество выходных токенов, доступных для этой модели.

supportedGenerationMethods[] string

Поддерживаемые моделью методы генерации.

Соответствующие имена методов API определяются как строки регистра Pascal, например, generateMessage и generateContent .

number temperature

Управляет случайностью вывода.

Значения могут находиться в диапазоне [0.0,maxTemperature] включительно. Более высокое значение приведет к более разнообразным ответам, в то время как значение, близкое к 0.0 , обычно приведет к менее неожиданным ответам модели. Это значение указывает значение по умолчанию, которое будет использоваться бэкэндом при вызове модели.

maxTemperature number

Максимальная температура, которую может использовать данная модель.

number topP

Для отбора проб ядра .

Выборка ядра рассматривает наименьший набор токенов, сумма вероятностей которых составляет не менее topP . Это значение указывает значение по умолчанию, которое будет использоваться бэкэндом при вызове модели.

topK integer

Для выборки Top-k.

Выборка top-k учитывает набор наиболее вероятных токенов topK . Это значение указывает значение по умолчанию, которое будет использоваться бэкендом при вызове модели. Если пусто, это означает, что модель не использует выборку top-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
}