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 „usługa przeciążona” (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 konieczne jest jawne ustawienie lokalizacji?

Firebase AI Logic ma automatyczne ustawienia domyślne lokalizacji (np. global, gdy używasz składni inicjowania „Agent Platform”). Jeśli jednak musisz lub chcesz użyć 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 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 usłudze global.

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

Ogólne informacje i sprawdzone metody

Oto kilka najważniejszych informacji i sprawdzonych metod dotyczących lokalizacji:

• Limity mocy obliczeniowej 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 w global niej dostępny).

• 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 lokalizacja global nie jest odpowiednia 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, używając Firebase Remote Config.

Przykładowe kody

Firebase AI Logic ma automatyczne ustawienia domyślne lokalizacji (np. global, gdy używana jest składnia inicjowania „Agent Platform”). Jeśli jednak chcesz lub musisz użyć innej lokalizacji, musisz ją wyraźnie określić 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 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 usłudze 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 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 usłudze 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