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

Модели генеративного ИИ 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 Gemini API (formerly Vertex AI) в коде.

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

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

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

// ...

Обратите внимание, что если вы укажете местоположение, где модель недоступна, вы получите ошибку 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 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.

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

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