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

Чтобы просмотреть контент и код, относящиеся к вашему поставщику API Gemini , нажмите на него. API разработчика Gemini API Vertex AI Gemini

Генеративные модели искусственного интеллекта от Google доступны в определенных регионах.

При инициализации бэкэнд-сервиса Vertex AI Gemini API в вашем коде вы можете дополнительно указать местоположение модели, к которой обращаетесь в своих запросах. Список доступных местоположений приведен далее на этой странице.

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

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

• Если вы не укажете местоположение, по умолчанию будет использоваться us-central1 .

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

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

Примечание: Данная страница не посвящена вопросу о том, можете ли вы, как разработчик, или один из ваших конечных пользователей в определенном регионе получить доступ к API Vertex AI Gemini .

На этой странице вы можете явно указать местоположение модели , к которой обращаетесь в своих запросах (например, для соблюдения требований к размещению данных).

Узнайте о местоположении global

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

Важно: Все предварительные и экспериментальные модели Gemini (за исключением моделей Gemini Live API ), выпущенные после июня 2025 года, доступны только в global расположении. Для доступа к этим моделям необходимо указать global расположение в вашем запросе (как показано в примерах кода ниже).

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

Примеры кода

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

Замените LOCATION на код местоположения (например, 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")

// ...

Kotlin

// ...

// 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")

// ...

Java

// ...

// 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);

// ...

Web

// ...

// 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' });

// ...

Dart

// ...

// 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 .

Важно: Любые правила или уведомления в документации Google Cloud , касающиеся местоположений, имеют приоритет над информацией, описанной здесь в документации Firebase.

Генеративный ИИ на платформе Vertex AI доступен в следующих регионах. Некоторые модели и/или конкретные версии могут быть недоступны во всех регионах (подробную информацию о доступности в разных регионах см. в документации Google Cloud ).

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

Соединенные Штаты

• Колумбус, Огайо ( us-east5 )
• Даллас, Техас ( us-south1 )
• Айова ( us-central1 )
• Лас-Вегас, Невада ( us-west4 )
• Монкс-Корнер, Южная Каролина ( us-east1 )
• Северная Вирджиния ( us-east4 )
• Орегон ( us-west1 )

Канада

• Монреаль ( northamerica-northeast1 )

Южная Америка

• Сан-Паулу, Бразилия ( southamerica-east1 )

Европа

• Бельгия ( europe-west1 )
• Финляндия ( europe-north1 )
• Франкфурт, Германия ( europe-west3 )
• Лондон, Великобритания ( europe-west2 )
• Мадрид, Испания ( europe-southwest1 )
• Милан, Италия ( europe-west8 )
• Нидерланды ( europe-west4 )
• Париж, Франция ( europe-west9 )
• Варшава, Польша ( europe-central2 )
• Цюрих, Швейцария ( europe-west6 )

Азиатско-Тихоокеанский регион

• Округ Чанхуа, Тайвань ( asia-east1 )
• Гонконг, Китай ( asia-east2 )
• Мумбаи, Индия ( asia-south1 )
• Сеул, Корея ( asia-northeast3 )
• Сингапур ( asia-southeast1 )
• Сидней, Австралия ( australia-southeast1 )
• Токио, Япония ( asia-northeast1 )

Средний Восток

• Даммам, Саудовская Аравия ( me-central2 )
• Доха, Катар ( me-central1 )
• Тель-Авив, Израиль ( me-west1 )

Примечание: API для программного отображения списка доступных местоположений отсутствует.