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ć ją w kodzie podczas inicjowania usługi Agent Platform Gemini API (formerly Vertex AI) backendu.

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

• Gemini Modele w wersji zapoznawczej i eksperymentalne: dostępne tylko w lokalizacji global (z wyjątkiem modeli Live API – patrz poniżej).

• Gemini 3.x modele: dostępne tylko w lokalizacji global w przypadku używania 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ć ją w kodzie podczas inicjowania usługi Agent Platform Gemini API (formerly Vertex AI) backendu.

Zastąp LOCATION kodem lokalizacji (np. global lub us-central1) 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 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 informujący, ż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 Agent Platform.

Generatywna AI w 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 tych lokalizacji:

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

• W przypadku wszystkich Gemini modeli w wersji zapoznawczej (z wyjątkiem modeli Live API) 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 lokalizacja global nie jest obsługiwana.

Gemini 3.x i nowsze modele

Gdy używasz Gemini 3.x i nowszych modeli z Firebase AI Logic, obsługiwane są te lokalizacje:

• global

Wkrótce dodamy obsługę lokalizacji us i eu.

Modele starszej generacji

Gdy używasz starszych Gemini modeli z Firebase AI Logic, obsługiwane są te lokalizacje:

Lista lokalizacji, które były wcześniej dostępne, ale zostały wyłączone:

• Nie wyłączono jeszcze żadnych lokalizacji.