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

Генеративные модели искусственного интеллекта Google доступны в определенных регионах. Каждый ваш запрос, использующий 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 автоматически использует адрес us-central1 для всех запросов. Если вам необходимо использовать другое местоположение, вам нужно явно указать его при инициализации бэкэнда API Vertex AI Gemini в вашем коде.

Обратите внимание, что в этих примерах показан доступ к модели 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");

// ...

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