Models

Punkt końcowy modeli umożliwia automatyczne wyświetlanie listy dostępnych modeli i pobieranie rozszerzonych metadanych, takich jak obsługiwane funkcje i rozmiar okna kontekstu. Więcej informacji znajdziesz w przewodniku po modelach.

Metoda: models.get

Pobiera informacje o konkretnym modelu Model, takie jak numer wersji, limity tokenów, parametry i inne metadane. Szczegółowe informacje o modelach znajdziesz w przewodniku po modelach Gemini.

Punkt końcowy

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

Parametry ścieżki

name string

Wymagane. Nazwa zasobu modelu.

Ta nazwa powinna być zgodna z nazwą modelu zwróconą przez metodę models.list.

Format: models/{model}. Ma on postać models/{model}.

Treść żądania

Treść żądania musi być pusta.

Przykładowe żądanie

Python

from google import genai

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

Go

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)

Muszla

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

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Model.

Metoda: models.list

Wyświetla listę Models dostępnych przez interfejs Gemini API.

Punkt końcowy

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

Parametry zapytania

pageSize integer

Maksymalna liczba elementów (Models) do zwrócenia (na stronę).

Jeśli nie podano tego argumentu, zwracanych jest 50 modeli na stronę. Ta metoda zwraca maksymalnie 1000 modeli na stronę, nawet jeśli przekażesz większą wartość pageSize.

pageToken string

Token strony otrzymany z poprzedniego wywołania models.list.

Podaj pageToken zwrócony przez jedno żądanie jako argument do następnego żądania, aby pobrać następną stronę.

Podczas stronicowania wszystkie inne parametry przekazywane do models.list muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść żądania

Treść żądania musi być pusta.

Przykładowe żądanie

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)

Go

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
		}
	}
}

Muszla

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

Treść odpowiedzi

Odpowiedź z ListModel zawierająca listę modeli podzieloną na strony.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Pola
models[] object (Model)

Zwrócone modele.

nextPageToken string

Token, który można wysłać jako pageToken, aby pobrać następną stronę.

Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zapis JSON 
{
  "models": [
    {
      object (Model)
    }
  ],
  "nextPageToken": string
}

Zasób REST: models

Zasób: model

Informacje o modelu języka generatywnego.

Pola
name string

Wymagane. Nazwa zasobu Model. Wszystkie dozwolone wartości znajdziesz w sekcji Warianty modelu.

Format: models/{model} z konwencją nazewnictwa {model}:

  • "{baseModelId}-{version}"

Przykłady:

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

Wymagane. Nazwa modelu podstawowego, którą należy przekazać do żądania generowania.

Przykłady:

  • gemini-1.5-flash
version string

Wymagane. Numer wersji modelu.

Oznacza to wersję główną (1.0 lub 1.5).

displayName string

Zrozumiała dla człowieka nazwa modelu. np. „Gemini 1.5 Flash”.

Nazwa może składać się z maksymalnie 128 znaków i zawierać dowolne znaki UTF-8.

description string

Krótki opis modelu.

inputTokenLimit integer

Maksymalna liczba tokenów wejściowych dozwolona w tym modelu.

outputTokenLimit integer

Maksymalna liczba tokenów wyjściowych dostępnych dla tego modelu.

supportedGenerationMethods[] string

Metody generowania obsługiwane przez model.

Odpowiadające im nazwy metod interfejsu API są definiowane jako ciągi znaków w notacji PascalCase, np. generateMessage i generateContent.

thinking boolean

Określa, czy model obsługuje rozumowanie.

temperature number

Określa losowość danych wyjściowych.

Wartości mogą wynosić od [0.0,maxTemperature] (włącznie). Wyższa wartość spowoduje, że odpowiedzi będą bardziej zróżnicowane, a wartość bliższa 0.0 zwykle spowoduje, że odpowiedzi modelu będą mniej zaskakujące. Ta wartość określa domyślne ustawienie, które będzie używane przez backend podczas wywoływania modelu.

maxTemperature number

Maksymalna temperatura, jaką może wykorzystać ten model.

topP number

W przypadku próbkowania jądra.

Próbkowanie jądra uwzględnia najmniejszy zbiór tokenów, których suma prawdopodobieństwa wynosi co najmniej topP. Ta wartość określa domyślne ustawienie, które będzie używane przez backend podczas wywoływania modelu.

topK integer

Do próbkowania Top-K.

Próbkowanie Top-K uwzględnia zbiór topK najbardziej prawdopodobnych tokenów. Ta wartość określa domyślne ustawienie, które będzie używane przez backend podczas wywoływania modelu. Jeśli jest pusta, oznacza to, że model nie używa próbkowania top-k, a parametr topK nie jest dozwolony jako parametr generowania.

Zapis 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
}

Metoda: models.predict

Wykonuje żądanie prognozy.

Punkt końcowy

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

Parametry ścieżki

model string

Wymagane. Nazwa modelu do prognozowania. Format: name=models/{model}. Ma on postać models/{model}.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Pola
instances[] value (Value format)

Wymagane. Instancje, które są danymi wejściowymi wywołania prognozy.

parameters value (Value format)

Opcjonalnie: Parametry zarządzające wywołaniem prognozy.

labels map (key: string, value: string)

Opcjonalnie: Etykiety z metadanymi zdefiniowanymi przez użytkownika dla żądania.

Opcjonalnie: Etykiety muszą spełniać standardowe wymagania dotyczące ujednoliconych etykiet Cloud: – klucze etykiet muszą zaczynać się od litery. – Klucze i wartości etykiet nie mogą być dłuższe niż 63 znaki (punkty kodowe Unicode). Mogą zawierać tylko małe litery, cyfry, podkreślenia i myślniki. - Znaki międzynarodowe są dozwolone.

Sposób użycia: identyfikatory bezpieczeństwa od agregatorów: użyj klucza safety_identifier (np. {"safety_identifier": "user_session_123"})

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

Treść odpowiedzi

Komunikat odpowiedzi dla [PredictionService.Predict].

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Pola
predictions[] value (Value format)

Dane wyjściowe wywołania prognozy.

Zapis JSON 
{
  "predictions": [
    value
  ]
}

Metoda: models.predictLongRunning

Tak samo jak models.predict, ale zwraca LRO.

Punkt końcowy

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

Parametry ścieżki

model string

Wymagane. Nazwa modelu do prognozowania. Format: name=models/{model}.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Pola
instances[] value (Value format)

Wymagane. Instancje, które są danymi wejściowymi wywołania prognozy.

parameters value (Value format)

Opcjonalnie: Parametry zarządzające wywołaniem prognozy.

webhookConfig.uris[] string

Opcjonalnie: Jeśli te identyfikatory URI webhooków są ustawione, będą używane do zdarzeń webhooków zamiast zarejestrowanych webhooków.

labels map (key: string, value: string)

Opcjonalnie: Etykiety z metadanymi zdefiniowanymi przez użytkownika dla żądania.

Opcjonalnie: Etykiety muszą spełniać standardowe wymagania dotyczące ujednoliconych etykiet Cloud: – klucze etykiet muszą zaczynać się od litery. – Klucze i wartości etykiet nie mogą być dłuższe niż 63 znaki (punkty kodowe Unicode). Mogą zawierać tylko małe litery, cyfry, podkreślenia i myślniki. - Znaki międzynarodowe są dozwolone.

Sposób użycia: identyfikatory bezpieczeństwa od agregatorów: użyj klucza safety_identifier (np. {"safety_identifier": "user_session_123"})

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation.