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. Każde z Twoich żądań korzystających z Vertex AI Gemini API musi zawierać lokalizację , w której można uzyskać dostęp do modelu. Firebase AI Logic automatycznie ustawia domyślną lokalizację us-central1 w przypadku wszystkich żądań.

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

Kiedy trzeba wyraźnie ustawić lokalizację?

Ponieważ Firebase AI Logic automatycznie ustawia domyślną lokalizację us-central1 w przypadku wszystkich żądań, jeśli chcesz używać innej lokalizacji, musisz ją wyraźnie określić podczas inicjowania usługi backendu Vertex AI Gemini API w kodzie.

W zależności od modelu wyraźne ustawienie lokalizacji może być wymagane. Jeśli żądanie próbuje uzyskać dostęp do modelu w lokalizacji, w której nie jest on dostępny, otrzymasz błąd 404 z informacją, że model was not found or your project does not have access to it.

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

• Gemini 3.x modele: podczas korzystania z usługi Firebase AI Logic wymagane jest wyraźne ustawienie lokalizacji na global. Firebase AI Logic nie obsługuje jeszcze lokalizacji us i eu.

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

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

Listę wszystkich dostępnych lokalizacji znajdziesz dalej na tej stronie.

Ogólne informacje i sprawdzone metody

Oto kilka najważniejszych informacji i sprawdzonych metod dotyczących lokalizacji:

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

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

• Rozważ użycie Firebase Remote Config , aby kontrolować lokalizację, z której uzyskujesz dostęp do modelu. Dzięki temu możesz zmienić lokalizację bez konieczności publikowania nowej wersji aplikacji.

• Jeśli ustawienie lokalizacji na global nie jest odpowiednie lub obsługiwane w Twoim przypadku, rozważ wyraźne określenie lokalizacji, z których 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

Firebase AI Logic automatycznie ustawia domyślną lokalizację us-central1 w przypadku wszystkich żądań. Jeśli chcesz używać innej lokalizacji, musisz ją wyraźnie określić podczas inicjowania usługi Vertex AI Gemini API backendu w kodzie.

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 określonym przez Ciebie 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:

• Firebase AI Logic domyślnie używa lokalizacji us-central1.

• W przypadku wszystkich Gemini modeli w wersji zapoznawczej (z wyjątkiem modeli Live API) 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. Firebase AI Logic nie obsługuje jeszcze lokalizacji us i eu.

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