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, opóźnienia, dostępności i trwałości.

Gdy korzystasz z Firebase AI Logic, każde żądanie, które używa parametru 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 model Agent Platform Gemini API (formerly Vertex AI) oferuje global lokalizację, co oznacza, że Twoje żądanie zostanie obsłużone przez dostępny model z dowolnego miejsca w globalnej puli.

Używanie 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 „Platforma agenta”). 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 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 w 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 globallokalizacji (jeśli model jest dostępny w globallokalizacji).

• Rozważ użycie Firebase Remote Config, aby określić 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 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 „Platforma agenta”). 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.

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 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 dla wszystkich ogólnodostępnych funkcji generatywnej AI w 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 domyślnie korzysta z tych lokalizacji:

  • 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 w 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 Cloud dokumentacji.

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

• Nie odrzucono jeszcze żadnych lokalizacji