Określ lokalizację, w której będzie można uzyskać dostęp do modelu

Modele generatywnej AI Google są dostępne w określonych regionach.

Podczas inicjowania usługi backendu Vertex AI Gemini API w kodzie, możesz określić lokalizację modelu, do którego uzyskujesz dostęp w żądaniach. Listę dostępnych lokalizacji znajdziesz dalej na tej stronie.

W przypadku dostępu do prawie wszystkich Gemini modeli interfejs Vertex AI Gemini API obsługuje lokalizację global, co oznacza, że Twoje żądanie zostanie obsłużone przez dostępny model z puli globalnej. Ustawienie lokalizacji global w żądaniach może pomóc uniknąć przekroczenia limitów pojemności modelu i zmniejszyć liczbę błędów „usługa przeciążona” (503).

W zależności od modelu ustawienie tej lokalizacji może być wymagane:

• Gemini w wersji zapoznawczej modele: wymagane jest ustawienie lokalizacji global jest wymagane (z wyjątkiem modeli w wersji zapoznawczej Live API).

• Gemini 3.x modele: podczas korzystania z Firebase AI Logic wymagane jest ustawienie lokalizacji global.

• Gemini 2.5 modele: ustawienie lokalizacji jest opcjonalne. Jeśli nie określisz lokalizacji, domyślnie zostanie użyta lokalizacja us-central1.

• Gemini Live API modele: ustawienie lokalizacji jest opcjonalne. Jeśli nie określisz lokalizacji, domyślnie zostanie użyta lokalizacja us-central1. Pamiętaj, że lokalizacja global nie jest obsługiwana.

Oto najważniejsze informacje i sprawdzone metody dotyczące lokalizacji:

• Limity pojemności są określane na model, region i minutę.

• Aby uniknąć nieoczekiwanego przekroczenia limitów pojemności, rozważ ustawienie lokalizacji global (jeśli Twój model obsługuje lokalizację global).

• Jeśli ustawienie lokalizacji global nie jest odpowiednie lub obsługiwane w Twoim przypadku użycia, rozważ wyraźne określenie, gdzie uzyskujesz dostęp do modeli. Możesz na przykład ustawić lokalizację na podstawie lokalizacji użytkownika, korzystając z Firebase Remote Config.

Przykładowe fragmenty kodu

Pamiętaj, że te przykłady pokazują dostęp do modelu Gemini, ale możesz też określić lokalizację podczas uzyskiwania dostępu do modelu Imagen.

Zastąp LOCATION kodem lokalizacji (np. global lub europe-west4) z listy dostępnych lokalizacji, którą znajdziesz dalej na tej stronie.

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
val model = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
                        .generativeModel("MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"))
        .generativeModel("MODEL_NAME");

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

// ...

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: 'MODEL_NAME' });

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// Create a `GenerativeModel` instance with a model that supports your use case
final model = ai.generativeModel(model: 'MODEL_NAME');

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(modelName: "MODEL_NAME");

// ...

Pamiętaj, że jeśli określisz lokalizację, w której model nie jest dostępny, otrzymasz błąd 404 z informacją, że model was not found or your project does not have access to it.

Dostępne lokalizacje

Google Cloud korzysta z regionów. Google Cloud przechowuje dane klientów tylko w regionie, który określisz w przypadku wszystkich ogólnie dostępnych funkcji generatywnej AI w Vertex AI.

Generatywna AI w Vertex AI jest dostępna w tych regionach. Niektóre modele lub ich konkretne wersje mogą nie być dostępne we wszystkich lokalizacjach (szczegółowe informacje o dostępności w poszczególnych lokalizacjach znajdziesz w Google Cloud dokumentacji).

Pamiętaj:

• W przypadku wszystkich Gemini w wersji zapoznawczej modeli (z wyjątkiem Live API modeli) jedyną obsługiwaną lokalizacją jest global.

• Podczas korzystania z Firebase AI Logic w celu uzyskania dostępu do modeli Gemini 3.x, jedyną obsługiwaną lokalizacją jest global.

• W przypadku wszystkich modeli Live API i wszystkich modeli Imagen lokalizacja global nie jest obsługiwana.