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

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

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

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

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

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

В 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 каталоге (за исключением моделей Live API — см. ниже).

• Модели Gemini 3.x : Доступно только в global расположении при использовании Firebase AI Logic . Firebase AI Logic пока не поддерживает расположения в us и eu .

• Модели Gemini 2.5 : доступны во многих местах .

• Модели Gemini Live API : доступны только в регионе us-central1 . global регион не поддерживается.

Список всех доступных локаций вы найдете далее на этой странице.

Общие факты и передовые методы

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

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

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

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

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

Примеры кода

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

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

// ...

// 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 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`.
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 использует местоположение us-central1 .

• Для всех предварительных версий Gemini (кроме версий Live API ) единственное поддерживаемое местоположение — global .

• При использовании Firebase AI Logic для доступа к моделям Gemini 3.x поддерживается только global местоположение. Firebase AI Logic пока не поддерживает местоположения us и eu .

• Для всех моделей Live API и всех моделей Imagen global местоположение не поддерживается.