Укажите местоположение для доступа к модели

Модели генеративного ИИ от Google доступны в определенных регионах. Вы можете выбрать, где получить доступ к модели, чтобы обеспечить соответствие требованиям, задержку, доступность и долговечность.

При использовании Firebase AI Logic каждый запрос, в котором используется Agent Platform Gemini API (formerly Vertex AI), может включать местоположение для доступа к модели. В Firebase AI Logic есть настройки геолокации по умолчанию.

• При использовании нового синтаксиса инициализации платформы агентов: global
• При использовании устаревшего синтаксиса инициализации Vertex AI: us-central1

О местоположении global

Для большинства моделей Gemini в Agent Platform Gemini API (formerly Vertex AI) доступно местоположение global. Это значит, что ваш запрос будет обработан доступной моделью из глобального пула.

Использование местоположения global для запросов поможет избежать превышения лимитов модели и сократить количество ошибок "Сервис перегружен" (503). Кроме того, в зависимости от модели использование местоположения global может быть обязательным, поскольку это единственное доступное местоположение для модели (например, предварительная версия модели Gemini).

Когда нужно явно задавать местоположение?

Firebase AI Logic имеет автоматические значения по умолчанию для местоположения (например, global при использовании синтаксиса инициализации Agent Platform). Однако если вы хотите использовать другое местоположение, вам нужно явно указать его при инициализации бэкенд-службы Agent Platform Gemini API (formerly Vertex AI) в коде.

Для некоторых моделей явное указание местоположения может быть обязательным. Если в запросе указана модель, недоступная в вашем регионе, вы получите ошибку 404 с сообщением was not found or your project does not have access to it.

• Предварительные и экспериментальные модели Gemini доступны только в регионе global.

• Стабильные модели Gemini 4.x и Gemini 3.x доступны в регионе global и часто в регионах us и eu.

• Модели Gemini 2.5 Доступны во многих странах. Обратите внимание, что модели Gemini Live API 2.5 не доступны в global.

Список всех доступных местоположений приведен ниже.

Общие факты и рекомендации

Вот несколько фактов и рекомендаций, касающихся местоположений:

• Ограничения емкости устанавливаются для каждой модели, региона и минуты.

• Чтобы избежать неожиданного достижения лимитов, используйте местоположение global (если модель доступна в этом местоположении global).

• Чтобы управлять местоположением, из которого вы получаете доступ к модели, используйте Firebase Remote Config. Это позволит вам менять местоположение, не выпуская новую версию приложения.

• Если местоположение global не подходит для вашего случая, вы можете явно указать, где вы получаете доступ к модели (если она доступна в других местоположенияхglobal). Например, вы можете задать местоположение на основе местоположения конечного пользователя с помощью Firebase Remote Config.

Примеры кода

Firebase AI Logic автоматически выбирает местоположение по умолчанию (например, global при использовании синтаксиса инициализации Agent Platform). Однако если вы хотите использовать другое местоположение, вам нужно явно указать его при инициализации бэкенд-службы Agent Platform Gemini API (formerly Vertex AI) в коде.

Замените LOCATION кодом местоположения (например, global или us-central1) из списка доступных местоположений ниже на этой странице.

// ...

// 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"));

// ...

Обратите внимание, что если вы укажете местоположение, в котором модель недоступна, вы получите ошибку 404 с сообщением о том, что модель was not found or your project does not have access to it.

Где доступна эта функция

Google Cloud использует регионы. Google Cloud хранит данные клиентов только в регионе, который вы указали для всех общедоступных функций генеративного искусственного интеллекта в Agent Platform.

Генеративный искусственный интеллект в Agent Platform доступен в перечисленных ниже регионах. Некоторые модели и/или их версии могут быть доступны не во всех регионах. Подробную информацию о доступности в разных регионах можно найти в документации по Google Cloud.

Обратите внимание:

• Firebase AI Logic по умолчанию сохраняется в следующих папках:

  • При использовании нового синтаксиса инициализации платформы агентов: global
  • При использовании устаревшего синтаксиса инициализации Vertex AI: us-central1

• Предварительные и экспериментальные модели Gemini доступны только в регионе global.

• Стабильные модели Gemini 4.x и Gemini 3.x доступны в регионе global и часто в регионах us и eu.

• Модели Gemini 2.5 Доступны во многих странах. Обратите внимание, что модели Gemini Live API 2.5 не доступны в global.

Gemini 3.x и более поздние модели

При использовании моделей Gemini 3.x и более поздних версий Firebase AI Logic поддерживает следующие местоположения:

• global
• us
• eu

Подробную информацию о доступных местоположениях для каждой модели можно найти в документации Google Cloud.

Модели предыдущих поколений

При использовании более старых моделей Gemini (например, 2.5) Firebase AI Logic поддерживает следующие местоположения:

Обратите внимание, что модели Gemini Live API 2.5 не доступны в global.

Подробную информацию о доступных местоположениях для каждой модели можно найти в документации Google Cloud.

Список местоположений, которые ранее были доступны, но теперь отключены:

• Пока нет отклоненных адресов.