Models

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

Метод: models.get

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

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

get https://generativelanguage.googleapis.com/v1beta/{name=models/*}

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

name string

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

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

Формат: models/{model}. Форма: models/{model}.

Тело запроса

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

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

Python

from google import genai

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

Проложить маршрут

ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
	APIKey:  os.Getenv("GEMINI_API_KEY"),
	Backend: genai.BackendGeminiAPI,
})
if err != nil {
	log.Fatal(err)
}

modelInfo, err := client.Models.Get(ctx, "gemini-3.8-flash", nil)
if err != nil {
	log.Fatal(err)
}

fmt.Println(modelInfo)

Ракушка

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

Тело ответа

Если ответ получен успешно, его тело содержит экземпляр Model.

Метод: models.list

Список Model, доступных через Gemini API.

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

get https://generativelanguage.googleapis.com/v1beta/models

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

pageSize integer

Максимальное количество объектов Models, которое может быть возвращено на одной странице.

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

pageToken string

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

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

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

Тело запроса

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

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

Python

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)

Проложить маршрут

ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
	APIKey:  os.Getenv("GEMINI_API_KEY"),
	Backend: genai.BackendGeminiAPI,
})
if err != nil {
	log.Fatal(err)
}

// Retrieve the list of models.
models, err := client.Models.List(ctx, &genai.ListModelsConfig{})
if err != nil {
	log.Fatal(err)
}

fmt.Println("List of models that support generateContent:")
for _, m := range models.Items {
	for _, action := range m.SupportedActions {
		if action == "generateContent" {
			fmt.Println(m.Name)
			break
		}
	}
}

fmt.Println("\nList of models that support embedContent:")
for _, m := range models.Items {
	for _, action := range m.SupportedActions {
		if action == "embedContent" {
			fmt.Println(m.Name)
			break
		}
	}
}

Ракушка

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

Тело ответа

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

Ниже приведена структура данных в ответе, полученном на запрос.

Поля
models[] object (Model)

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

nextPageToken string

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

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

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

Ресурс 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 определяются как строки в стиле PascalCase, например generateMessage и generateContent.

thinking boolean

Поддерживает ли модель режим рассуждения.

temperature number

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

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

maxTemperature number

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

topP number

Для ядерной выборки.

При выборке по ядру рассматривается наименьший набор токенов, сумма вероятностей которых составляет не менее 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
  ],
  "thinking": boolean,
  "temperature": number,
  "maxTemperature": number,
  "topP": number,
  "topK": integer
}

Метод: models.predict

Выполняет запрос на прогнозирование.

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

post https://generativelanguage.googleapis.com/v1beta/{model=models/*}:predict

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

model string

Обязательно. Название модели для прогнозирования. Формат: name=models/{model}. Форма: models/{model}.

Тело запроса

Ниже приведена структура данных в теле запроса.

Поля
instances[] value (Value format)

Обязательно. Экземпляры, которые являются входными данными для вызова прогноза.

parameters value (Value format)

Необязательное поле. Параметры, управляющие вызовом прогноза.

labels map (key: string, value: string)

Необязательное поле. Ярлыки с пользовательскими метаданными для запроса.

Необязательное поле. Ярлыки должны соответствовать стандартным требованиям к унифицированным ярлыкам Cloud: - Ключи ярлыков должны начинаться с буквы. - Ключи и значения ярлыков могут содержать не более 63 символов (кодовых точек Unicode) и состоять только из строчных букв, цифр, символов подчеркивания и тире. - Можно использовать буквы английского и других алфавитов.

Использование: - Идентификаторы безопасности от агрегаторов: используйте ключ safety_identifier (например, {"safety_identifier": "user_session_123"})

Объект содержит список из нескольких пар ("key": value). Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Тело ответа

Сообщение ответа для [PredictionService.Predict].

Ниже приведена структура данных в ответе, полученном на запрос.

Поля
predictions[] value (Value format)

Выходные данные вызова прогноза.

JSON-представление 
{
  "predictions": [
    value
  ]
}

Метод: models.predictLongRunning

То же, что и models.predict, но возвращает LRO.

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

post https://generativelanguage.googleapis.com/v1beta/{model=models/*}:predictLongRunning

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

model string

Обязательно. Название модели для прогнозирования. Формат: name=models/{model}.

Тело запроса

Ниже приведена структура данных в теле запроса.

Поля
instances[] value (Value format)

Обязательно. Экземпляры, которые являются входными данными для вызова прогноза.

parameters value (Value format)

Необязательное поле. Параметры, управляющие вызовом прогноза.

webhookConfig.uris[] string

Необязательное поле. Если задать эти URI, они будут использоваться для событий вебхуков вместо зарегистрированных вебхуков.

labels map (key: string, value: string)

Необязательное поле. Ярлыки с пользовательскими метаданными для запроса.

Необязательное поле. Ярлыки должны соответствовать стандартным требованиям к унифицированным ярлыкам Cloud: - Ключи ярлыков должны начинаться с буквы. - Ключи и значения ярлыков могут содержать не более 63 символов (кодовых точек Unicode) и состоять только из строчных букв, цифр, символов подчеркивания и тире. - Можно использовать буквы английского и других алфавитов.

Использование: - Идентификаторы безопасности от агрегаторов: используйте ключ safety_identifier (например, {"safety_identifier": "user_session_123"})

Объект содержит список из нескольких пар ("key": value). Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Тело ответа

Если ответ получен успешно, его тело содержит экземпляр Operation.