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

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

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

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

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

Практически для всех моделей Gemini API платформы агентов Gemini (ранее Vertex AI) обеспечивает global местоположение, что означает, что ваш запрос будет обработан доступной моделью в любой точке глобального пула.

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

В каких случаях необходимо явно указывать местоположение?

В Firebase AI Logic местоположение задается автоматически по умолчанию (например, global при использовании синтаксиса инициализации "Agent Platform"). Однако, если вам необходимо использовать другое местоположение, вам нужно явно указать его во время инициализации бэкэнд-сервиса Agent Platform Gemini API (ранее 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"). Однако, если вам необходимо использовать другое местоположение, вам нужно явно указать его во время инициализации бэкэнд-сервиса Agent Platform Gemini API (ранее 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 .

Список ранее доступных, но теперь отклоненных мест:

• Пока ни одному месту не было отказано.

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

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

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

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

Практически для всех моделей Gemini API платформы агентов Gemini (ранее Vertex AI) обеспечивает global местоположение, что означает, что ваш запрос будет обработан доступной моделью в любой точке глобального пула.

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

В каких случаях необходимо явно указывать местоположение?

В Firebase AI Logic местоположение задается автоматически по умолчанию (например, global при использовании синтаксиса инициализации "Agent Platform"). Однако, если вам необходимо использовать другое местоположение, вам нужно явно указать его во время инициализации бэкэнд-сервиса Agent Platform Gemini API (ранее 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"). Однако, если вам необходимо использовать другое местоположение, вам нужно явно указать его во время инициализации бэкэнд-сервиса Agent Platform Gemini API (ранее 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 .

Список ранее доступных, но теперь отклоненных мест:

• Пока ни одному месту не было отказано.

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

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

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

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

Практически для всех моделей Gemini API платформы агентов Gemini (ранее Vertex AI) обеспечивает global местоположение, что означает, что ваш запрос будет обработан доступной моделью в любой точке глобального пула.

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

В каких случаях необходимо явно указывать местоположение?

В Firebase AI Logic местоположение задается автоматически по умолчанию (например, global при использовании синтаксиса инициализации "Agent Platform"). Однако, если вам необходимо использовать другое местоположение, вам нужно явно указать его во время инициализации бэкэнд-сервиса Agent Platform Gemini API (ранее 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"). Однако, если вам необходимо использовать другое местоположение, вам нужно явно указать его во время инициализации бэкэнд-сервиса Agent Platform Gemini API (ранее 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 .

Список ранее доступных, но теперь отклоненных мест:

• Пока ни одному месту не было отказано.

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

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

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

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

Практически для всех моделей Gemini API платформы агентов Gemini (ранее Vertex AI) обеспечивает global местоположение, что означает, что ваш запрос будет обработан доступной моделью в любой точке глобального пула.

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

В каких случаях необходимо явно указывать местоположение?

В Firebase AI Logic местоположение задается автоматически по умолчанию (например, global при использовании синтаксиса инициализации "Agent Platform"). Однако, если вам необходимо использовать другое местоположение, вам нужно явно указать его во время инициализации бэкэнд-сервиса Agent Platform Gemini API (ранее 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"). Однако, если вам необходимо использовать другое местоположение, вам нужно явно указать его во время инициализации бэкэнд-сервиса Agent Platform Gemini API (ранее 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 поддерживает следующие местоположения:

Note that Gemini Live API 2.5 models are not available in global .

For details about the available locations for each model , see the Google Cloud documentation .

List of previously available, but now turned-down locations:

• No locations have been turned down yet