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

Модели генеративного ИИ от 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
• europe-west2 (Лондон, Великобритания)
• asia-southeast1 (Сингапур)

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

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

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

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

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

Список стран, в которых функция была доступна ранее, но теперь отключена:

• Пока не было отклонено ни одного местоположения.