Deployment dan endpoint (original) (raw)

Halaman ini mencantumkan lokasi yang didukung untuk model Google dan Partner serta fitur AI generatif di Gemini Enterprise Agent Platform.

Untuk melihat lokasi yang didukung untuk agen Google dan fitur infrastruktur agen, lihat Lokasi yang didukung untuk agen.

Model dan fitur AI generatif Google dan Partner di Gemini Enterprise Agent Platform diekspos sebagai endpoint regional tertentu dan endpoint global. Endpoint global mencakup seluruh dunia dan memberikan ketersediaan dan keandalan yang lebih tinggi daripada region tunggal.

Menentukan endpoint

Untuk endpoint regional standar (seperti us-central) dan endpoint global:

Python

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

vertexai.init(project='GOOGLE_CLOUD_PROJECT', location='GOOGLE_CLOUD_LOCATION')

Python

client = genai.Client(
    enterprise=True,
    project='GOOGLE_CLOUD_PROJECT',
    location='GOOGLE_CLOUD_LOCATION'
)

REST

GOOGLE_CLOUD_PROJECT="GOOGLE_CLOUD_PROJECT"
GOOGLE_CLOUD_LOCATION="GOOGLE_CLOUD_LOCATION"
MODEL_ID="MODEL_ID"

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

Endpoint multi-region

Endpoint multi-region memungkinkan Anda memastikan bahwa pemrosesan machine learning Data Pelanggan oleh layanan tetap berada dalam batas yurisdiksi tertentu, seperti Amerika Serikat atau Uni Eropa.

Tabel berikut mencantumkan nama host untuk endpoint multi-region:

Python

import vertexai
from google.adk.agents import Agent

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

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

Python

from google import genai

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

REST

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

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

Konektivitas pribadi ke endpoint multi-region

Akses Google Pribadi tidak didukung untuk endpoint multi-region. Jika Anda mencoba terhubung ke endpoint multi-region menggunakan Akses Google Pribadi, Anda mungkin mengalami masalah konektivitas, error handshake SSL/TLS, atau peringatan ketidakcocokan sertifikat.

Untuk membuat konektivitas pribadi ke endpoint multi-region, Anda harus mengonfigurasi endpoint Private Service Connect untuk Google API regional.

Endpoint Global

Memilih endpoint global untuk permintaan Anda dapat meningkatkan ketersediaan secara keseluruhan sekaligus mengurangi error resource habis (429). Jangan gunakan endpoint global jika Anda memiliki persyaratan pemrosesan ML, karena Anda tidak dapat mengontrol atau mengetahui region tempat permintaan pemrosesan ML Anda dikirim saat permintaan dibuat.

Model yang didukung

Penggunaan endpoint global didukung untuk model Google berikut di wilayah tertentu. Untuk mengetahui detail tentang model mana yang mendukung endpoint global, lihat tab Global di tabel lokasi endpoint model Google.

• Gambar Gemini 3 Pro
• Gambar Gemini 3.1 Flash
• Gemini 3.5 Flash
• Gemini 3.1 Flash-Lite
• Gemini 3.1 Flash Image (Pratinjau)
• Gemini 3.1 Pro (Pratinjau)
• Gemini 3 Flash (Pratinjau)
• Gambar Gemini 3 Pro (Pratinjau)
• Gemini 2.5 Pro
• Gemini 2.5 Flash (Pratinjau)
• Gemini 2.5 Flash-Lite (Pratinjau)
• Gambar Gemini 2.5 Flash
• Gemini 2.5 Flash
• Gemini 2.5 Flash-Lite

Untuk mengetahui informasi tentang ketersediaan endpoint global untuk model partner, lihat tabGlobal diGoogle Cloud tabel lokasi endpoint model partner.

Batasan

Kemampuan berikut tidak tersedia saat menggunakan endpoint global:

• Penyesuaian
• Prediksi batch untuk model Anthropic dan OpenMaaS
• Korpus retrieval-augmented generation (RAG) (permintaan RAG didukung)

Penggunaan endpoint global dengan Throughput yang Disediakan hanya tersedia untuk model berikut:

Lokasi endpoint model Google

Model Google di Gemini Enterprise Agent Platform tersedia untuk endpoint berikut:

Google Cloud lokasi endpoint model partner

Google menayangkan permintaan dari region yang Anda tentukan. Untuk beberapa model, Google juga menawarkan endpoint global untuk meningkatkan ketersediaan secara keseluruhan dan mengurangi rasio error. Endpoint global dapat memiliki serangkaian kuota terpisah dari endpoint regional dan tidak mendukung persyaratan residensi data. Untuk mengetahui informasi selengkapnya, lihat bagian "Endpoint regional dan global" di Model partner Gemini Enterprise Agent Platform untuk MaaS.

Endpoint model partner untuk Agent Platform tersedia di region berikut:

Global

Multi-region

Amerika Serikat

Amerika

Eropa

Asia Pasifik

Timur Tengah

Lokasi endpoint model terbukaGoogle Cloud

Google menayangkan permintaan dari region yang Anda tentukan. Untuk beberapa model, Google juga menawarkan endpoint global untuk meningkatkan ketersediaan secara keseluruhan dan mengurangi rasio error. Endpoint global dapat memiliki serangkaian kuota terpisah dari endpoint regional dan tidak mendukung persyaratan residensi data. Untuk informasi selengkapnya, lihat bagian "Endpoint regional dan global" di Model terbuka Gemini Enterprise Agent Platform untuk MaaS.

Endpoint model terbuka untuk Agent Platform tersedia di region berikut: