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

Modele generatywnej AI od Google są dostępne w określonych regionach. Każde żądanie korzystające z funkcji Vertex AI Gemini API musi zawierać lokalizację, w której można uzyskać dostęp do modelu. Firebase AI Logic jest domyślnie ustawione na us-central1 w przypadku wszystkich żądań.

W przypadku niemal wszystkich modeli Gemini model Vertex AI Gemini API obsługuje global lokalizację, co oznacza, że Twoje żądanie zostanie obsłużone przez dostępny model z dowolnego miejsca na świecie. Korzystanie z lokalizacji global w przypadku żądań może pomóc uniknąć osiągnięcia limitów pojemności modelu i zmniejszyć liczbę błędów „usługa przeciążona” (503). W zależności od modelu korzystanie z globallokalizacji może być wymagane.

Kiedy trzeba wyraźnie określić lokalizację?

Ponieważ w przypadku wszystkich żądań Firebase AI Logic automatycznie przyjmuje wartość domyślną us-central1, jeśli chcesz użyć innej lokalizacji, musisz wyraźnie określić ją 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 Twoja prośba próbuje uzyskać dostęp do modelu w lokalizacji, w której jest on niedostępny, otrzymasz błąd 404 z informacją, że model was not found or your project does not have access to it.

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

• Gemini 3.x modele: w przypadku korzystania z Firebase AI Logic wymagane jest wyraźne ustawienie lokalizacji na global. Usługa 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ślną wartością będzie us-central1.

• Gemini Live API modele: wyraźne ustawienie lokalizacji jest opcjonalne, ale zalecane. Jeśli nie określisz lokalizacji, domyślną wartością będzie us-central1. Pamiętaj, że lokalizacja global nie jest obsługiwana.

Listę wszystkich dostępnych lokalizacji znajdziesz w dalszej części tej strony.

Ogólne informacje i sprawdzone metody

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

• Limity pojemności są określane dla każdego modelu, regionu i minuty.

• Aby uniknąć nieoczekiwanego osiągnięcia limitów pojemności, rozważ ustawienie lokalizacji na global (jeśli Twój model obsługuje 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 publikowania nowej wersji aplikacji.

• Jeśli ustawienie lokalizacji na global nie ma zastosowania w Twoim przypadku lub nie jest obsługiwane, 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

W przypadku wszystkich żądań Firebase AI Logic automatycznie przyjmuje wartość domyślną us-central1. Jeśli chcesz użyć innej lokalizacji, musisz ją wyraźnie określić podczas inicjowania usługi backendu Vertex AI Gemini API 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 symbol LOCATION kodem lokalizacji (np. global lub europe-west4) z listy dostępnych lokalizacji, która znajduje się 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 jest niedostępny, otrzymasz błąd 404 z informacją, że modelwas 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 dla wszystkich ogólnodostępnych funkcji generatywnej AI na platformie Vertex AI.

Generatywna AI w usłudze Vertex AI jest dostępna w tych regionach: Niektóre modele lub konkretne wersje mogą być niedostępne w niektórych lokalizacjach (szczegółowe informacje o dostępności w poszczególnych lokalizacjach znajdziesz w Google Clouddokumentacji).

Pamiętaj:

• Firebase AI Logic domyślnie znajduje się w lokalizacji us-central1.

• W przypadku wszystkich modeli w Gemini wersji podglądowej (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 Logicnie obsługuje jeszcze lokalizacji us i eu.

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