Models  |  Gemini API  |  Google AI for Developers
Skip to main content
/
English
Deutsch
Español – América Latina
Français
Indonesia
Italiano
Polski
Português – Brasil
Shqip
Tiếng Việt
Türkçe
Русский
עברית
العربيّة
فارسی
हिंदी
বাংলা
ภาษาไทย
中文 – 简体
中文 – 繁體
日本語
한국어
Get API key
Cookbook
Community
Sign in
Docs
API reference
Gemini API
Docs
API reference
Get API key
Cookbook
Community
Overview
API versions
Core APIs
Interactions API
GenerateContent
Real time APIs
Live API
Live Music API
Platform APIs
Model API
Agents
Webhooks
Triggers
Batch API
Files API
Tokens
Caching
Embeddings
File Search API
File search stores
Documents
All methods
SDK references
Python
Go
TypeScript
Java
C#
The Interactions API is now generally available. We recommend using this API for access to all the latest features and models.
Home
Gemini API
API reference
Send feedback
Models
The models endpoint provides a way for you to programmatically list the available models, and retrieve extended metadata such as supported functionality and context window sizing. Read more in the Models guide.
Method: models.get
Endpoint
Path parameters
Request body
Response body
Authorization scopes
Example request
Get
Gets information about a specific Model such as its version number, token limits, parameters and other metadata. Refer to the Gemini models guide for detailed model information.
Endpoint
get
https://generativelanguage.googleapis.com/v1beta/{name=models/*}
Path parameters
name
string
Required. The resource name of the model.
This name should match a model name returned by the models.list method.
Format: models/{model} It takes the form models/{model}.
Request body
The request body must be empty.
Example request
Python
from google import genai
client = genai.Client()
model_info = client.models.get(model="gemini-3.5-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-3.5-flash", nil)
if err != nil {
log.Fatal(err)
}
fmt.Println(modelInfo)
models.go
Shell
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash?key=$GEMINI_API_KEY
models.sh
Response body
If successful, the response body contains an instance of Model.
Method: models.list
Endpoint
Query parameters
Request body
Response body
JSON representation
Authorization scopes
Example request
List
Lists the Models available through the Gemini API.
Endpoint
get
https://generativelanguage.googleapis.com/v1beta/models
Query parameters
pageSize
integer
The maximum number of Models to return (per page).
If unspecified, 50 models will be returned per page. This method returns at most 1000 models per page, even if you pass a larger pageSize.
pageToken
string
A page token, received from a previous models.list call.
Provide the pageToken returned by one request as an argument to the next request to retrieve the next page.
When paginating, all other parameters provided to models.list must match the call that provided the page token.
Request body
The request body must be empty.
Example request
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
Shell
curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY
models.sh
Response body
Response from ListModel containing a paginated list of Models.
If successful, the response body contains data with the following structure:
Fields
models[]
object (Model)
The returned Models.
nextPageToken
string
A token, which can be sent as pageToken to retrieve the next page.
If this field is omitted, there are no more pages.
JSON representation
{
"models": [
{
object (Model)
}
],
"nextPageToken": string
}
REST Resource: models
Resource: Model
JSON representation
Methods
Resource: Model
Information about a Generative Language Model.
Fields
name
string
Required. The resource name of the Model. Refer to Model variants for all allowed values.
Format: models/{model} with a {model} naming convention of:
"{baseModelId}-{version}"
Examples:
models/gemini-1.5-flash-001
baseModelId
string
Required. The name of the base model, pass this to the generation request.
Examples:
gemini-1.5-flash
version
string
Required. The version number of the model.
This represents the major version (1.0 or 1.5)
displayName
string
The human-readable name of the model. E.g. "Gemini 1.5 Flash".
The name can be up to 128 characters long and can consist of any UTF-8 characters.
description
string
A short description of the model.
inputTokenLimit
integer
Maximum number of input tokens allowed for this model.
outputTokenLimit
integer
Maximum number of output tokens available for this model.
supportedGenerationMethods[]
string
The model's supported generation methods.
The corresponding API method names are defined as Pascal case strings, such as generateMessage and generateContent.
thinking
boolean
Whether the model supports thinking.
temperature
number
Controls the randomness of the output.
Values can range over [0.0,maxTemperature], inclusive. A higher value will produce responses that are more varied, while a value closer to 0.0 will typically result in less surprising responses from the model. This value specifies default to be used by the backend while making the call to the model.
maxTemperature
number
The maximum temperature this model can use.
topP
number
For Nucleus sampling.
Nucleus sampling considers the smallest set of tokens whose probability sum is at least topP. This value specifies default to be used by the backend while making the call to the model.
topK
integer
For Top-k sampling.
Top-k sampling considers the set of topK most probable tokens. This value specifies default to be used by the backend while making the call to the model. If empty, indicates the model doesn't use top-k sampling, and topK isn't allowed as a generation parameter.
JSON representation
{
"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
}
Method: models.predict
Endpoint
Path parameters
Request body
JSON representation
Response body
JSON representation
Authorization scopes
Performs a prediction request.
Endpoint
post
https://generativelanguage.googleapis.com/v1beta/{model=models/*}:predict
Path parameters
model
string
Required. The name of the model for prediction. Format: name=models/{model}. It takes the form models/{model}.
Request body
The request body contains data with the following structure:
Fields
instances[]
value (Value format)
Required. The instances that are the input to the prediction call.
parameters
value (Value format)
Optional. The parameters that govern the prediction call.
Response body
Response message for [PredictionService.Predict].
If successful, the response body contains data with the following structure:
Fields
predictions[]
value (Value format)
The outputs of the prediction call.
JSON representation
{
"predictions": [
value
]
}
Method: models.predictLongRunning
Endpoint
Path parameters
Request body
JSON representation
Response body
Authorization scopes
Same as models.predict but returns an LRO.
Endpoint
post
https://generativelanguage.googleapis.com/v1beta/{model=models/*}:predictLongRunning
Path parameters
model
string
Required. The name of the model for prediction. Format: name=models/{model}.
Request body
The request body contains data with the following structure:
Fields
instances[]
value (Value format)
Required. The instances that are the input to the prediction call.
parameters
value (Value format)
Optional. The parameters that govern the prediction call.
Response body
If successful, the response body contains an instance of Operation.
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-04-24 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-04-24 UTC."],[],[]]
Terms
Privacy
Manage cookies
English
Deutsch
Español – América Latina
Français
Indonesia
Italiano
Polski
Português – Brasil
Shqip
Tiếng Việt
Türkçe
Русский
עברית
العربيّة
فارسی
हिंदी
বাংলা
ภาษาไทย
中文 – 简体
中文 – 繁體
日本語
한국어