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

Informacje o lokalizacji global

W przypadku prawie wszystkich Gemini modeli, Agent Platform Gemini API (formerly Vertex AI) oferuje global lokalizację, 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). Ponadto w zależności od modelu używanie lokalizacji global może być wymagane ponieważ jest to jedyna dostępna lokalizacja dla modelu (np. modelu w wersji Preview Gemini ).

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żyć innej lokalizacji, musisz wyraźnie określić ją w kodzie podczas inicjowania usługi backendu Agent Platform Gemini API (formerly Vertex AI).

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 z informacją, że model was not found or your project does not have access to it.

• Gemini Modele w wersji Preview i eksperymentalnej: dostępne tylko w lokalizacji global.

• Gemini 4.x i Gemini 3.x modele stabilne: dostępne w lokalizacji global oraz często w lokalizacjach us i eu.

• Gemini 2.5 modele: dostępne w wielu lokalizacjach. Pamiętaj, że Gemini Live API 2.5 modele nie są dostępne w lokalizacji global.

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

Ogólne informacje i sprawdzone metody

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

• Limity pojemności dotyczą każdego modelu, każdego regionu i każdej minuty.

• Aby uniknąć nieoczekiwanego przekroczenia limitów pojemności, rozważ użycie lokalizacji global (jeśli model jest dostępny w tej lokalizacji 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 w Twoim przypadku, rozważ wyraźne określenie lokalizacji, w której uzyskujesz dostęp do modelu (jeśli model jest dostępny w lokalizacjach innych niż global). 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żyć innej lokalizacji, musisz wyraźnie określić ją w kodzie podczas inicjowania usługi backendu Agent Platform Gemini API (formerly Vertex AI).

Zastąp LOCATION kodem lokalizacji (np. global lub us-central1) z listy dostępnych lokalizacji w dalszej części tej strony.

// ...

// 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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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 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

• Gemini Modele w wersji Preview i eksperymentalnej: dostępne tylko w lokalizacji global.

• Gemini 4.x i Gemini 3.x modele stabilne: dostępne w lokalizacji global oraz często w lokalizacjach us i eu.

• Gemini 2.5 modele: dostępne w wielu lokalizacjach. Pamiętaj, że Gemini Live API 2.5 modele nie są dostępne w lokalizacji global.

Gemini 3.x i nowsze modele

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

• global
• us
• eu
• europe-west2 (Londyn, Wielka Brytania)
• asia-southeast1 (Singapur)

Szczegółowe informacje o dostępnych lokalizacjach każdego modelu znajdziesz w Google Cloud dokumentacji.

Modele starszej generacji

Gdy używasz starszych Gemini modeli (np. modeli 2.5), Firebase AI Logic obsługuje te lokalizacje:

Pamiętaj, że Gemini Live API 2.5 modele nie są dostępne w lokalizacji global.

Szczegółowe informacje o dostępnych lokalizacjach każdego modelu znajdziesz w Google Cloud dokumentacji.

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

• Nie wyłączono jeszcze żadnych lokalizacji.