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. Możesz wybrać, gdzie chcesz uzyskać dostęp do modelu, aby spełnić wymagania dotyczące zgodności, opóźnienia, dostępności i trwałości.

Gdy używasz Firebase AI Logic, każde żądanie korzystające z Agent Platform Gemini API (formerly Vertex AI) może opcjonalnie zawierać lokalizację, w której ma być dostępny model. Firebase AI Logic ma domyślne ustawienia lokalizacji.

• Gdy używasz nowej składni inicjowania „Agent Platform”: global
• Gdy używasz starszej składni inicjowania „Vertex AI”: us-central1

W przypadku prawie wszystkich Gemini modeli Agent Platform Gemini API (formerly Vertex AI) obsługuje lokalizację global, co oznacza, że Twoje żądanie zostanie obsłużone przez dostępny model w dowolnym miejscu globalnej puli. Używanie 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 używanie lokalizacji global może być też wymagane.

Kiedy trzeba wyraźnie ustawić lokalizację?

Firebase AI Logic ma automatyczne ustawienia domyślne lokalizacji (np. global w przypadku używania składni inicjowania „Agent Platform”). Jeśli jednak chcesz używać innej lokalizacji, musisz wyraźnie określić lokalizację podczas inicjowania usługi backendu Agent Platform Gemini API (formerly Vertex AI) 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 preview i eksperymentalnej: dostępne tylko w lokalizacji global (z wyjątkiem Live API – patrz poniżej).

• Gemini 3.x modele: dostępne tylko w lokalizacji global w przypadku korzystania z Firebase AI Logic. Firebase AI Logic nie obsługuje jeszcze lokalizacji us i eu.

• Gemini 2.5 modele: dostępne w wielu lokalizacjach.

• Gemini Live API modele: dostępne tylko w lokalizacji us-central1. 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ż użycie lokalizacji global (jeśli Twój model ją obsługuje).global

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

• Jeśli używanie lokalizacji global nie jest odpowiednie lub obsługiwane w Twoim przypadku, 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

Firebase AI Logic ma automatyczne ustawienia domyślne lokalizacji (np. global w przypadku używania składni inicjowania „Agent Platform”). Jeśli jednak chcesz używać innej lokalizacji, musisz wyraźnie określić lokalizację podczas inicjowania usługi backendu Agent Platform Gemini API (formerly Vertex AI) w kodzie.

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

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatformBackend` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexai` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
let ai = FirebaseAI.firebaseAI(backend: .vertexai(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// ...

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 usłudze Agent Platform.

Generatywna AI w usłudze Agent Platform 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 lokalizacjach znajdziesz w Google Cloud dokumentacji).

Pamiętaj:

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

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

• Gdy używasz Firebase AI Logic do uzyskiwania 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.