Models

Über den Modelle-Endpunkt können Sie die verfügbaren Modelle programmgesteuert auflisten und erweiterte Metadaten wie unterstützte Funktionen und die Größe des Kontextfensters abrufen. Weitere Informationen im Leitfaden zu Modellen

Methode: models.get

Ruft Informationen zu einem bestimmten Model ab, z. B. die Versionsnummer, Tokenlimits, Parameter und andere Metadaten. Ausführliche Informationen zu den Modellen finden Sie im Leitfaden zu Gemini-Modellen.

Endpunkt

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

Pfadparameter

name string

Erforderlich. Der Ressourcenname des Modells.

Dieser Name sollte mit einem Modellnamen übereinstimmen, der von der Methode models.list zurückgegeben wird.

Format: models/{model} Sie nimmt die Form models/{model} an.

Anfragetext

Der Anfragetext muss leer sein.

Beispielanfrage

Python

from google import genai

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

Ok

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.7-flash", nil)
if err != nil {
	log.Fatal(err)
}

fmt.Println(modelInfo)

Muschel

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

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Model.

Methode: models.list

Listet die Models auf, die über die Gemini API verfügbar sind.

Endpunkt

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

Suchparameter

pageSize integer

Die maximale Anzahl der zurückzugebenden Models (pro Seite).

Wenn nicht angegeben, werden 50 Modelle pro Seite zurückgegeben. Diese Methode gibt maximal 1.000 Modelle pro Seite zurück, auch wenn Sie einen größeren Wert für „pageSize“ übergeben.

pageToken string

Ein Seitentoken, das von einem vorherigen models.list-Aufruf empfangen wurde.

Geben Sie das von einer Anfrage zurückgegebene pageToken als Argument für die nächste Anfrage an, um die nächste Seite abzurufen.

Beim Paginieren müssen alle anderen für models.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Beispielanfrage

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)

Ok

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

Muschel

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

Antworttext

Antwort von ListModel mit einer paginierten Liste von Modellen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Felder
models[] object (Model)

Die zurückgegebenen Modelle.

nextPageToken string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen.

Wenn dieses Feld weggelassen wird, gibt es keine weiteren Seiten.

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

REST-Ressource: models

Ressource: Modell

Informationen zu einem generativen Sprachmodell.

Felder
name string

Erforderlich. Der Ressourcenname von Model. Alle zulässigen Werte finden Sie unter Modellvarianten.

Format: models/{model} mit der Namenskonvention {model}:

  • "{baseModelId}-{version}"

Beispiele:

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

Erforderlich. Der Name des Basismodells, der an die Generierungsanfrage übergeben wird.

Beispiele:

  • gemini-1.5-flash
version string

Erforderlich. Die Versionsnummer des Modells.

Dies stellt die Hauptversion (1.0 oder 1.5) dar.

displayName string

Der für Menschen lesbare Name des Modells. Beispiel: „Gemini 1.5 Flash“.

Der Name kann bis zu 128 Zeichen lang sein und aus beliebigen UTF-8-Zeichen bestehen.

description string

Eine kurze Beschreibung des Modells.

inputTokenLimit integer

Maximale Anzahl von Eingabetokens, die für dieses Modell zulässig sind.

outputTokenLimit integer

Maximale Anzahl von Ausgabetokens, die für dieses Modell verfügbar sind.

supportedGenerationMethods[] string

Die unterstützten Generierungsmethoden des Modells.

Die entsprechenden API-Methodennamen sind als Pascal-Case-Strings definiert, z. B. generateMessage und generateContent.

thinking boolean

Gibt an, ob das Modell das Denken unterstützt.

temperature number

Steuert die Zufälligkeit der Ausgabe.

Die Werte können bis zu [0.0,maxTemperature] betragen. Ein höherer Wert führt zu vielfältigeren Antworten, während ein Wert, der näher an 0.0 liegt, in der Regel zu weniger überraschenden Antworten des Modells führt. Dieser Wert gibt den Standard an, der vom Backend beim Aufrufen des Modells verwendet werden soll.

maxTemperature number

Die maximale Temperatur, die dieses Modell verwenden kann.

topP number

Für Nucleus Sampling.

Beim Nucleus Sampling wird die kleinste Menge von Tokens berücksichtigt, deren Wahrscheinlichkeitssumme mindestens topP beträgt. Dieser Wert gibt den Standard an, der vom Backend beim Aufrufen des Modells verwendet werden soll.

topK integer

Für Top-K-Sampling.

Beim Top-k-Sampling wird die Menge der topK wahrscheinlichsten Tokens berücksichtigt. Dieser Wert gibt den Standard an, der vom Backend beim Aufrufen des Modells verwendet werden soll. Wenn leer, gibt dies an, dass das Modell kein Top-k-Sampling verwendet und topK nicht als Generierungsparameter zulässig ist.

JSON-Darstellung 
{
  "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
}

Methode: models.predict

Führt eine Vorhersageanfrage aus.

Endpunkt

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

Pfadparameter

model string

Erforderlich. Der Name des Modells für die Vorhersage. Format: name=models/{model}. Sie nimmt die Form models/{model} an.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

Felder
instances[] value (Value format)

Erforderlich. Die Instanzen, die die Eingabe für den Vorhersageaufruf sind.

parameters value (Value format)

Optional. Die Parameter, die den Vorhersageaufruf steuern.

Antworttext

Antwortnachricht für [PredictionService.Predict].

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Felder
predictions[] value (Value format)

Die Ausgaben des Vorhersageaufrufs.

JSON-Darstellung 
{
  "predictions": [
    value
  ]
}

Methode: models.predictLongRunning

Identisch mit „models.predict“, gibt aber einen LRO zurück.

Endpunkt

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

Pfadparameter

model string

Erforderlich. Der Name des Modells für die Vorhersage. Format: name=models/{model}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

Felder
instances[] value (Value format)

Erforderlich. Die Instanzen, die die Eingabe für den Vorhersageaufruf sind.

parameters value (Value format)

Optional. Die Parameter, die den Vorhersageaufruf steuern.

webhookConfig.uris[] string

Optional. Wenn diese Webhook-URIs festgelegt sind, werden sie anstelle der registrierten Webhooks für Webhook-Ereignisse verwendet.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.