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

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

При использовании Firebase AI Logic каждый ваш запрос, использующий API Vertex AI Gemini, должен включать адрес для доступа к модели. Firebase AI Logic автоматически устанавливает адрес us-central1 для всех запросов.

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

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

Поскольку Firebase AI Logic автоматически использует us-central1 для всех запросов, если вам необходимо или вы хотите использовать другое местоположение, вам нужно явно указать его при инициализации бэкэнд-сервиса Vertex AI Gemini API в вашем коде.

В зависимости от модели может потребоваться явное указание местоположения. Если ваш запрос пытается получить доступ к модели, расположенной в недоступном для неё месте, вы получите ошибку 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 : Явное указание местоположения необязательно, но рекомендуется. Если вы не укажете местоположение, по умолчанию будет использоваться us-central1 .

• Модели Gemini Live API : Явное указание местоположения необязательно, но рекомендуется. Если вы не указываете местоположение, по умолчанию используется us-central1 . Обратите внимание, что global местоположение не поддерживается.

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

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

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

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

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

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

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

Примеры кода

Firebase AI Logic automatically defaults to us-central1 for all requests. If you need or want to use a different location, then you need to explicitly specify the location during initialization of the Vertex AI Gemini API backend service in your code.

Обратите внимание, что в этих примерах показан доступ к модели Gemini , но при доступе к модели Imagen вы также можете указать местоположение.

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

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
val model = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
                        .generativeModel("MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"))
        .generativeModel("MODEL_NAME");

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

// ...

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: 'MODEL_NAME' });

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// Create a `GenerativeModel` instance with a model that supports your use case
final model = ai.generativeModel(model: 'MODEL_NAME');

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(modelName: "MODEL_NAME");

// ...

Note that if you specify a location where the model isn't available, you'll get a 404 error that says the model was not found or your project does not have access to it .

Доступные места

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

Генеративный ИИ на платформе Vertex AI доступен в следующих регионах. Некоторые модели и/или конкретные версии могут быть недоступны во всех регионах (подробную информацию о доступности в разных регионах см. в документации 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 местоположение не поддерживается.