Models

L'endpoint dei modelli consente di elencare in modo programmatico i modelli disponibili e recuperare metadati estesi come funzionalità supportate e dimensionamento della finestra contestuale. Scopri di più nella guida ai modelli.

Metodo: models.get

Recupera informazioni su un Model specifico, ad esempio il numero di versione, i limiti dei token, i parametri e altri metadati. Per informazioni dettagliate sui modelli, consulta la guida ai modelli Gemini.

Endpoint

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

Parametri del percorso

name string

Obbligatorio. Il nome della risorsa del modello.

Questo nome deve corrispondere a un nome del modello restituito dal metodo models.list.

Formato: models/{model}. Assume la forma models/{model}.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Esempio di richiesta

Python

from google import genai

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

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

fmt.Println(modelInfo)
models.go

Conchiglia

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

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Model.

Metodo: models.list

Elenca i Model disponibili tramite l'API Gemini.

Endpoint

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

Parametri di query

pageSize integer

Il numero massimo di Models da restituire (per pagina).

Se non specificato, vengono restituiti 50 modelli per pagina. Questo metodo restituisce al massimo 1000 modelli per pagina, anche se passi un valore pageSize maggiore.

pageToken string

Un token di pagina, ricevuto da una precedente chiamata models.list.

Fornisci il valore pageToken restituito da una richiesta come argomento della richiesta successiva per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a models.list devono corrispondere alla chiamata che ha fornito il token di pagina.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Esempio di richiesta

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)
models.py

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
		}
	}
}
models.go

Conchiglia

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

Corpo della risposta

Risposta da ListModel contenente un elenco paginato di modelli.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Campi
models[] object (Model)

I modelli restituiti.

nextPageToken string

Un token, che può essere inviato come pageToken per recuperare la pagina successiva.

Se questo campo viene omesso, non verranno visualizzate altre pagine.

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

Risorsa REST: models

Risorsa: Modello

Informazioni su un modello linguistico generativo.

Campi
name string

Obbligatorio. Il nome risorsa di Model. Per tutti i valori consentiti, consulta Varianti del modello.

Formato: models/{model} con una convenzione di denominazione {model} di:

  • "{baseModelId}-{version}"

Esempi:

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

Obbligatorio. Il nome del modello di base, passalo alla richiesta di generazione.

Esempi:

  • gemini-1.5-flash
version string

Obbligatorio. Il numero di versione del modello.

Rappresenta la versione principale (1.0 o 1.5)

displayName string

Il nome leggibile del modello. Ad esempio "Gemini 1.5 Flash".

Il nome può avere fino a 128 caratteri e può essere composto da qualsiasi carattere UTF-8.

description string

Una breve descrizione del modello.

inputTokenLimit integer

Numero massimo di token di input consentiti per questo modello.

outputTokenLimit integer

Numero massimo di token di output disponibili per questo modello.

supportedGenerationMethods[] string

I metodi di generazione supportati del modello.

I nomi dei metodi API corrispondenti sono definiti come stringhe Pascal Case, ad esempio generateMessage e generateContent.

thinking boolean

Se il modello supporta il pensiero.

temperature number

Controlla la casualità dell'output.

I valori possono variare in un intervallo di [0.0,maxTemperature], inclusi. Un valore più alto produrrà risposte più varie, mentre un valore più vicino a 0.0 in genere genererà risposte meno sorprendenti da parte del modello. Questo valore specifica il valore predefinito da utilizzare dal backend durante la chiamata al modello.

maxTemperature number

La temperatura massima che questo modello può utilizzare.

topP number

Per il campionamento del nucleo.

Il campionamento del nucleo considera il più piccolo insieme di token la cui somma di probabilità è almeno topP. Questo valore specifica il valore predefinito da utilizzare dal backend durante la chiamata al modello.

topK integer

Per il campionamento Top-K.

Il campionamento Top-k considera l'insieme dei topK token più probabili. Questo valore specifica il valore predefinito da utilizzare dal backend durante la chiamata al modello. Se è vuoto, indica che il modello non utilizza il campionamento top-k e che topK non è consentito come parametro di generazione.

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