Models

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

Метод: models.get

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

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

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

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

string name

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

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

Формат: models/{model} Он принимает вид models/{model} .

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

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

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

Python 

from google import genai

client = genai.Client()
model_info = client.models.get(model="gemini-3.6-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.6-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_KEY

Ответный текст

В случае успеха тело ответа содержит экземпляр 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 должны соответствовать вызову, который предоставил токен страницы.

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

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

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

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_KEY

Ответный текст

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

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

Поля
models[] object ( Model )

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

string nextPageToken

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

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

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

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

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

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

Поля
string name

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

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

  • "{baseModelId}-{version}"

Примеры:

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

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

Примеры:

  • 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 case, например, generateMessage и generateContent .

boolean thinking

Способствует ли данная модель развитию мышления.

number temperature

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

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

number maxTemperature

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

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
  ],
  "thinking": boolean,
  "temperature": number,
  "maxTemperature": number,
  "topP": number,
  "topK": integer
}

Метод: models.predict

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

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

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

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

string model

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

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

Тело запроса содержит данные следующей структуры:

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

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

значение parameters value ( Value format)

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

Ответный текст

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

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

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

Результаты запроса на прогнозирование.

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

Метод: models.predictLongRunning

Аналогично models.predict, но возвращает LRO.

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

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

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

string model

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

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

Тело запроса содержит данные следующей структуры:

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

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

значение parameters value ( Value format)

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

webhookConfig.uris[] string

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

Ответный текст

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