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. 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, które korzysta z Agent Platform Gemini API (formerly Vertex AI), może opcjonalnie zawierać lokalizację, aby uzyskać dostęp do modelu. Firebase AI Logic ma domyślne ustawienia lokalizacji.

• Podczas korzystania z nowej składni inicjowania „Agent Platform”: global
• Jeśli używasz starszej składni inicjowania „Vertex AI”: us-central1

Informacje o lokalizacji global

W przypadku prawie wszystkich modeli Gemini Agent Platform Gemini API (formerly Vertex AI) oferuje lokalizację global, co oznacza, że Twoje żądanie zostanie obsłużone przez dostępny model w dowolnym miejscu w globalnej puli.

Używanie lokalizacji global w żądaniach może pomóc uniknąć osiągnięcia limitów pojemności modelu i zmniejszyć liczbę błędów „przeciążenie usługi” (503). W zależności od modelu użycie lokalizacji global może być wymagane, ponieważ jest to jedyna dostępna lokalizacja dla modelu (na przykład modelu Gemini w wersji testowej).

Kiedy trzeba jawnie ustawić lokalizację?

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

W zależności od modelu jawne 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.

• Modele Gemini w wersji testowej i eksperymentalne: dostępne tylko w lokalizacji global.

• Modele stabilne Gemini 4.x i Gemini 3.x: dostępne w lokalizacji global, a często też w lokalizacjach us i eu.

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

Listę wszystkich dostępnych lokalizacji znajdziesz poniżej.

Ogólne informacje i sprawdzone metody

Oto kilka kluczowych faktów i sprawdzonych metod dotyczących lokalizacji:

• Limity zasobów są określane na model, na region i na minutę.

• Aby uniknąć nieoczekiwanego osiągnięcia limitów, rozważ użycie lokalizacji global (jeśli model jest dostępny w lokalizacji 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 korzystanie z lokalizacji global nie jest odpowiednie w Twoim przypadku, rozważ wyraźne określenie, gdzie 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, gdy używasz składni inicjowania „Agent Platform”). Jeśli jednak chcesz lub musisz użyć 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 us-central1) z listy dostępnych lokalizacji, którą znajdziesz poniżej 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-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 podasz lokalizację, w której model nie jest dostępny, pojawi się 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 dla 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ą być niedostępne w niektórych lokalizacjach (szczegółowe informacje o dostępności w poszczególnych lokalizacjach znajdziesz w dokumentacji Google Cloud).

Pamiętaj:

• Firebase AI Logic domyślnie używa tych lokalizacji:

  • Podczas korzystania z nowej składni inicjowania „Agent Platform”: global
  • Jeśli używasz starszej składni inicjowania „Vertex AI”: us-central1

• Modele Gemini w wersji testowej i eksperymentalne: dostępne tylko w lokalizacji global.

• Modele stabilne Gemini 4.x i Gemini 3.x: dostępne w lokalizacji global, a często też w lokalizacjach us i eu.

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

Gemini 3.x i nowsze modele

W przypadku modeli Gemini 3.x i nowszych Firebase AI Logic obsługuje te lokalizacje:

• global
• us
• eu

Szczegółowe informacje o dostępnych lokalizacjach poszczególnych modeli znajdziesz w dokumentacji Google Cloud.

Starsze modele

W przypadku korzystania ze starszych modeli Gemini (takich jak 2.5) Firebase AI Logic obsługuje te lokalizacje:

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

Szczegółowe informacje o dostępnych lokalizacjach poszczególnych modeli znajdziesz w dokumentacji Google Cloud.

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

• Nie odrzucono jeszcze żadnych lokalizacji