Deployments and endpoints

Google and Partner models and generative AI features on Gemini Enterprise Agent Platform are exposed as specific regional endpoints and a global endpoint. Global endpoints cover the entire world and provide higher availability and reliability than single regions.

Specify an endpoint

For standard regional endpoints (such as us-central ) and the global endpoint:

 # google-cloud-aiplatform >= 1.79.0 is required
import vertexai
from vertexai.generative_models import GenerativeModel

vertexai.init(project=' PROJECT_ID 
', location=' LOCATION 
') 

 # google-genai >= 0.8.0 is required
client = genai.Client(
    vertexai=True,
    project=' PROJECT_ID 
',
    location=' LOCATION 
'
) 

 PROJECT_ID=" PROJECT_ID 
"
LOCATION=" LOCATION 
"
MODEL_ID=" MODEL_ID 
"

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://${LOCATION}$-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${LOCATION}/publishers/google/models/${MODEL_ID}:generateContent" \
  -d '{
    "contents": {
      "role": "user",
      "parts": {
        "text": "Explain how AI works in a few words."
      }
    }
  }' 

For multi-region endpoints:

 from google import genai

client = genai.Client(
    vertexai=True,
    project=' PROJECT_ID 
',
    location=' LOCATION 
',
) 

 GOOGLE_CLOUD_PROJECT= PROJECT_ID 
;
GOOGLE_CLOUD_LOCATION=" LOCATION 
";
API_ENDPOINT="https://aiplatform.${GOOGLE_CLOUD_LOCATION}.rep.googleapis.com";
MODEL_ID=" MODEL_ID 
";
GENERATE_CONTENT_API="generateContent";

curl \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"${API_ENDPOINT}/v1/projects/${GOOGLE_CLOUD_PROJECT}/locations/${GOOGLE_CLOUD_LOCATION}/publishers/google/models/${MODEL_ID}:${GENERATE_CONTENT_API}" -d \
$'{
  "contents": {
    "role": "user",
    "parts": {
      "text": "Explain how AI works in a few words"
    }
  }
}' 

Global endpoint

Selecting a global endpoint for your requests can improve overall availability while reducing resource exhausted (429) errors. Don't use the global endpoint if you have ML processing requirements, because you can't control or know which region your ML processing requests are sent to when a request is made.

Supported models

Usage of the global endpoint is supported for the following Google models in specified regions. For details about which models support the global endpoint, see the Globaltab in the Google model endpoint locations table .

• Gemini 3.1 Flash-Lite (Preview)
• Gemini 3.1 Flash Image (Preview)
• Gemini 3.1 Pro (Preview)
• Gemini 3 Flash (Preview)
• Gemini 3 Pro (Preview)
• Gemini 3 Pro Image (Preview)
• Gemini 2.5 Pro
• Gemini 2.5 Flash (Preview)
• Gemini 2.5 Flash-Lite (Preview)
• Gemini 2.5 Flash Image
• Gemini 2.5 Flash
• Gemini 2.5 Flash-Lite
• Gemini 2.0 Flash
• Gemini 2.0 Flash-Lite

For information about global endpoint availability for partner models, see the Globaltab in the Google Cloud partner model endpoint locations table .

Limitations

The following capabilities are not available when using the global endpoint:

• Tuning
• Batch prediction for Anthropic and OpenMaaS models
• Retrieval-augmented generation (RAG) corpus (RAG requests are supported)

Usage of the global endpoint with Provisioned Throughput is available only for the following models:

Google model endpoint locations

Google models in Gemini Enterprise Agent Platform are available for the following endpoints:

Google Cloud partner model endpoint locations

Google serves requests from the region that you specified. For some models, Google also offers a global endpoint to improve overall availability and reduce error rates. The global endpoint can have a separate set of quotas from the regional endpoint and doesn't support data residency requirements. For more information, see the "Regional and global endpoint" section in Gemini Enterprise Agent Platform partner models for MaaS .

Partner model endpoints for Agent Platform are available in the following regions:

Google Cloud open model endpoint locations

Google serves requests from the region that you specified. For some models, Google also offers a global endpoint to improve overall availability and reduce error rates. The global endpoint can have a separate set of quotas from the regional endpoint and doesn't support data residency requirements. For more information, see the "Regional and global endpoint" section in Gemini Enterprise Agent Platform open models for MaaS .

Open model endpoints for Agent Platform are available in the following regions: