Models

Über den Endpunkt „models“ 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 finden Sie im Modellleitfaden.

Methode: models.get

Ruft Informationen zu einer 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

erhalten 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 hat das Format models/{model}.

Anfragetext

Der Anfragetext muss leer sein.

Beispielanfrage

Python

model_info = genai.get_model("models/gemini-1.5-flash-latest")
print(model_info)
models.py

Muschel

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

Antworttext

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

Methode: models.list

Liste der über die Gemini API verfügbaren Models.

Endpunkt

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

Abfrageparameter

pageSize integer

Die maximale Anzahl von Models, die zurückgegeben werden sollen (pro Seite).

Wenn nicht angegeben, werden 50 Modelle pro Seite zurückgegeben. Mit dieser Methode werden maximal 1.000 Modelle pro Seite zurückgegeben, auch wenn Sie eine größere pageSize übergeben.

pageToken string

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

Geben Sie die 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

print("List of models that support generateContent:\n")
for m in genai.list_models():
    if "generateContent" in m.supported_generation_methods:
        print(m.name)

print("List of models that support embedContent:\n")
for m in genai.list_models():
    if "embedContent" in m.supported_generation_methods:
        print(m.name)
models.py

Muschel

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

Antworttext

Antwort von ListModel mit einer paginaten 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, sind keine Seiten mehr vorhanden.

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

REST-Ressource: models

Ressource: Modell

Informationen zu einem generativen Sprachmodell.

Felder
name string

Erforderlich. Der Ressourcenname des Model. Weitere Informationen zu allen zulässigen Werten finden Sie unter Modellvarianten.

Format: models/{model} mit einer {model}-Benennungskonvention:

  • „{baseModelId}-{version}“

Beispiele:

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

Erforderlich. Der Name des Basismodells. Übergeben Sie diesen an die Generierungsanfrage.

Beispiele:

  • gemini-1.5-flash
version string

Erforderlich. Die Versionsnummer des Modells.

Dies ist die Hauptversion (1.0 oder 1.5).

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

Maximal zulässige Anzahl von Eingabetokens für dieses Modell.

outputTokenLimit integer

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

supportedGenerationMethods[] string

Die vom Modell unterstützten Generierungsmethoden.

Die entsprechenden API-Methodennamen werden als Strings in Pascal-Schreibweise definiert, z. B. generateMessage und generateContent.

temperature number

Steuert die Zufälligkeit der Ausgabe.

Die Werte können bis einschließlich [0.0,maxTemperature] liegen. 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 die Standardeinstellung an, die vom Back-End beim Aufruf des Modells verwendet werden soll.

maxTemperature number

Die maximale Temperatur, die dieses Modell verwenden kann.

topP number

Für Nucleus-Stichproben.

Bei der Nucleus-Stichprobe wird die kleinste Gruppe von Tokens berücksichtigt, deren Wahrscheinlichkeitssumme mindestens topP beträgt. Dieser Wert gibt die Standardeinstellung an, die vom Back-End beim Aufruf des Modells verwendet werden soll.

topK integer

Für Top-K-Sampling.

Beim Top-K-Sampling wird die Gruppe der topK wahrscheinlichsten Tokens berücksichtigt. Dieser Wert gibt die Standardeinstellung an, die vom Back-End beim Aufruf des Modells verwendet werden soll. Wenn das Feld leer ist, wird im Modell keine Top-K-Stichprobenerhebung verwendet und topK ist nicht als Generierungsparameter zulässig.

JSON-Darstellung 
{
  "name": string,
  "baseModelId": string,
  "version": string,
  "displayName": string,
  "description": string,
  "inputTokenLimit": integer,
  "outputTokenLimit": integer,
  "supportedGenerationMethods": [
    string
  ],
  "temperature": number,
  "maxTemperature": number,
  "topP": number,
  "topK": integer
}