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."
      }
    }
  }' 

Multi-region endpoints

Multi-region endpoints allow you to ensure that machine learning processing of Customer Data by the service stays within a specific jurisdictional boundary, such as the United States or the European Union.

The following table lists the hostnames for multi-region endpoints:

 import vertexai
from google.adk.agents import Agent

# Set the multi-region location on the client
client = vertexai.Client(
    project=' PROJECT_ID 
',
    location=' LOCATION 
'
)

# The agent will use this configuration
agent = Agent(
    model="gemini-2.5-flash",
    name='my_agent'
) 

 from google import genai

# location must be set to 'us' or 'eu' for multi-region routing
client = genai.Client(
    vertexai=True,
    project=' PROJECT_ID 
',
    location=' LOCATION 
'
) 

 PROJECT_ID=" PROJECT_ID 
"
MODEL_ID=" MODEL_ID 
"
LOCATION=" LOCATION 
" # Must be 'us' or 'eu'
# Explicitly use the .rep. hostname for multi-region endpoints
API_ENDPOINT="https://aiplatform.${LOCATION}.rep.googleapis.com"

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "${API_ENDPOINT}/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"
      }
    }
  }' 

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
• Gemini 3.1 Flash Image (Preview)
• Gemini 3.1 Pro (Preview)
• Gemini 3 Flash (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

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: