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ć miejsce dostępu do modelu, aby spełnić wymagania dotyczące zgodności, czasu oczekiwania, dostępności i trwałości.

Gdy korzystasz z Firebase AI Logic, każde żądanie, które używa 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.

• Jeśli używasz 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 z dowolnego miejsca na świecie.

Używanie lokalizacji global w przypadku żądań może pomóc w uniknięciu 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 danego modelu (np. model Gemini w wersji podglądowej).

Kiedy konieczne jest wyraźne ustawienie lokalizacji?

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

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

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

• Gemini 3.x modele stabilne: dostępne w global, a często także w 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 w dalszej części tej strony.

Ogólne informacje i sprawdzone metody

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

• Limity pojemności są określane dla każdego modelu, regionu i minuty.

• Aby uniknąć nieoczekiwanego osiągnięcia limitów pojemności, rozważ użycie modelu global w lokalizacji global (jeśli jest tam 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 jest on 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 fragmenty kodu

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

Zastąp symbol LOCATION kodem lokalizacji (np. global lub us-central1) z listy dostępnych lokalizacji, która znajduje się 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 jest niedostępny, otrzymasz błąd 404 z informacją, że modelwas 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 dla wszystkich ogólnodostępnych funkcji generatywnej AI na platformie Agent Platform.

Generatywna AI w usłudze Agent Platform jest dostępna w tych regionach: Niektóre modele lub konkretne wersje mogą nie być dostępne we wszystkich lokalizacjach (szczegółowe informacje o dostępności w poszczególnych lokalizacjach znajdziesz w Google Cloud dokumentacji).

Pamiętaj:

• Firebase AI Logic ma domyślnie te lokalizacje:

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

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

• Gemini 3.x modele stabilne: dostępne w global, a często także w 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

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 Google Cloud dokumentacji.

Modele starszej generacji

W przypadku starszych modeli Gemini (np. modeli 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 Google Clouddokumentacji.

Lista lokalizacji, które były wcześniej dostępne, ale obecnie nie są:

• Nie odrzucono jeszcze żadnych lokalizacji