Firebase AI Logic supports Gemini 3 Pro and Gemini 3 Pro Image (nano banana pro) for use on all platforms (in preview).

Эта страница переведена с помощью Cloud Translation API.

Переход на Firebase AI Logic SDKs из версии GA Vertex AI в Firebase SDKs

Firebase AI Logic и его клиентские SDK ранее назывались " Vertex AI in Firebase ". Чтобы лучше отразить расширение наших сервисов и функций (например, теперь мы поддерживаем API для разработчиков Gemini !), мы переименовали и переупаковали наши сервисы в Firebase AI Logic .

Для безопасного доступа к генеративным моделям искусственного интеллекта Google непосредственно из ваших мобильных или веб-приложений теперь можно выбрать поставщика « Gemini API » — либо давно доступный Vertex AI Gemini API , либо Gemini Developer API . Это означает, что теперь у вас есть возможность использовать Gemini Developer API , который предоставляет бесплатный уровень с разумными ограничениями скорости и квотами.

Обзор шагов по миграции на SDK Firebase AI Logic .

Шаг 1 : Выберите лучшего поставщика " Gemini API " для вашего приложения и сценариев использования.
Шаг 2 : Настройте свой проект Firebase, чтобы вы могли использовать API разработчика Gemini .
Применимо только в том случае, если вы переходите на использование API разработчика Gemini вместо API Vertex AI Gemini .
Шаг 3 : Обновите библиотеку, используемую в вашем приложении.
Шаг 4 : Обновите параметры инициализации в вашем приложении.
Шаг 5 : Обновите свой код в зависимости от используемых вами функций.

Шаг 1 : Выберите лучшего поставщика "Gemini API" для вашего приложения.

В результате этой миграции у вас есть выбор поставщика " Gemini API ":

Старые SDK " Vertex AI in Firebase " могли использовать только API Vertex AI Gemini .
Новые SDK Firebase AI Logic позволяют выбирать, к какому поставщику " Gemini API " вы хотите обращаться напрямую из своего мобильного или веб-приложения — либо к Gemini Developer API , либо к Vertex AI Gemini API .

Ознакомьтесь с различиями между использованием двух API-провайдеров Gemini , особенно в отношении поддерживаемых функций, ценообразования и ограничений скорости. Например, API для разработчиков Gemini не поддерживает предоставление файлов с использованием URL-адресов Cloud Storage , но это может быть хорошим выбором, если вы хотите воспользоваться его бесплатным уровнем и разумным лимитом трафика.

Важно : Если вы хотите использовать «бесплатный уровень» для API разработчика Gemini , вам необходимо понизить версию проекта Firebase, который вы используете с клиентскими SDK, до бесплатного тарифного плана Spark (то есть, отвязать учетную запись Cloud Billing ). Перед понижением версии убедитесь, что вы не зависите от каких-либо других сервисов или квот, требующих тарифного плана Blaze.

Если ваш проект Firebase останется в рамках тарифного плана Blaze, то вы будете использовать один из «платных уровней» для API разработчика Gemini .

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

Шаг 2 : Настройте свой проект Firebase, чтобы вы могли использовать API разработчика Gemini.

Этот шаг необходим только в том случае, если вы хотите перейти на использование API разработчика Gemini с клиентскими SDK Firebase AI Logic . Однако, если вы хотите продолжать использовать API Vertex AI Gemini , перейдите к следующему шагу.

Обратите внимание, что одновременное включение обоих провайдеров "Gemini API" в вашем проекте допустимо.

В консоли Firebase перейдите на страницу Firebase AI Logic .
Перейдите на вкладку «Настройки» и выберите Gemini Developer API .
Включите API разработчика Gemini .
Консоль проверит, включены ли необходимые API, и сгенерирует ключ API Gemini в вашем проекте Firebase.
Не добавляйте этот API-ключ Gemini в код вашего приложения. Узнайте больше.
Продолжите выполнение инструкций в этом руководстве по миграции, чтобы обновить библиотеку и выполнить инициализацию в вашем приложении.

Шаг 3 : Обновите библиотеку, используемую в вашем приложении.

Обновите код своего приложения, чтобы использовать библиотеку Firebase AI Logic .

Быстрый

В Xcode, открыв проект приложения, обновите пакет Firebase до версии 11.13.0 или более поздней, используя один из следующих вариантов:
- Вариант 1 : Обновить все пакеты: Перейдите в меню Файл > Пакеты > Обновить до последних версий пакетов .
- Вариант 2 : Обновите Firebase по отдельности: Перейдите к пакету Firebase в разделе « Зависимости пакета» . Щелкните правой кнопкой мыши по пакету Firebase и выберите «Обновить пакет» .
Убедитесь, что в списке необходимых пакетов Firebase отображается версия 11.13.0 или более поздняя. Если это не так, проверьте, позволяют ли указанные вами требования к пакету обновить его до версии 11.13.0 или более поздней.
В редакторе проектов выберите целевой объект вашего приложения, а затем перейдите в раздел «Фреймворки, библиотеки и встроенный контент» .
Добавьте новую библиотеку: выберите кнопку «+» , а затем добавьте FirebaseAI из пакета Firebase.
После завершения миграции вашего приложения (см. остальные разделы этого руководства) обязательно удалите старую библиотеку:
Выберите FirebaseVertexAI , а затем нажмите кнопку — .

Kotlin

В файле Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) замените старые зависимости (если применимо) следующими.

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

// BEFORE
dependencies {
  implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
  implementation("com.google.firebase:firebase-vertexai")
  // OR if not using the BoM
  implementation("com.google.firebase:firebase-vertexai:16.x.y")
}


// AFTER
dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.6.0"))

  // Add the dependency for the Firebase AI Logic library
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
}

Синхронизируйте свой Android-проект с файлами Gradle.

Обратите внимание, что если вы решите не использовать Firebase Android BoM , просто добавьте зависимость для библиотеки firebase-ai и примите последнюю версию, предложенную Android Studio.

Java

// BEFORE
dependencies {
  implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
  implementation("com.google.firebase:firebase-vertexai")
  // OR if not using the BoM
  implementation("com.google.firebase:firebase-vertexai:16.x.y")
}


// AFTER
dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.6.0"))

  // Add the dependency for the Firebase AI Logic library
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
}

Синхронизируйте свой Android-проект с файлами Gradle.

Web

Получите последнюю версию Firebase JS SDK для веб-разработки с помощью npm:
```
npm i firebase@latest
```
ИЛИ
```
yarn add firebase@latest
```
Везде, где вы импортировали библиотеку, обновите операторы импорта, используя firebase/ai вместо этого.
Обратите внимание, что, возможно, будет проще перенести кодовую базу вашего приложения (см. остальные разделы этого руководства) до удаления старых импортов.
```
// BEFORE
import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai";


// AFTER
import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel } from "firebase/ai";
```

Dart

Для обновления и добавления пакета firebase_ai в файл pubspec.yaml выполните следующую команду из каталога вашего проекта Flutter:
```
flutter pub add firebase_ai
```
Пересоберите свой проект Flutter:
```
flutter run
```
После завершения миграции вашего приложения (см. остальные разделы этого руководства) обязательно удалите старый пакет:
```
flutter pub remove firebase_vertexai
```

Единство

Поддержка Unity в " Vertex AI in Firebase " отсутствовала.

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Шаг 4 : Обновите инициализацию в вашем приложении.

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

Обновите способ инициализации сервиса для выбранного вами API-провайдера и создайте экземпляр GenerativeModel .

Быстрый


import FirebaseAILogic

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

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

Kotlin


// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-2.5-flash")

Java


// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-2.5-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web


import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

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

// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-2.5-flash" });

Dart


import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-2.5-flash');

Единство

Поддержка Unity в " Vertex AI in Firebase " отсутствовала.

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

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

Для доступа к модели Imagen создайте экземпляр ImagenModel .

Шаг 5 : Обновите свой код в зависимости от используемых вами функций.

На этом шаге описываются изменения, которые могут потребоваться в зависимости от используемых вами функций.

Если вы используете URL-адреса Cloud Storage и в ходе миграции перешли на использование API разработчика Gemini , вам необходимо обновить ваши мультимодальные запросы, чтобы включать файлы в качестве встроенных данных (или использовать URL-адреса YouTube для видео).
Ознакомьтесь со следующими списками, чтобы внести необходимые изменения в свой код для работы с Firebase AI Logic SDK.

Быстрый

Никаких дополнительных изменений.

Kotlin

Live API
- Удалено значение UNSPECIFIED для класса перечисления ResponseModality . Вместо него используйте null .

Java

Live API
- Удалено значение UNSPECIFIED для класса перечисления ResponseModality . Вместо него используйте null .
Внесены изменения в различные методы Java-конструктора, теперь они корректно возвращают экземпляр класса, а не void.

Web

Изменения необходимы только в том случае, если вы начинаете использовать API разработчика Gemini (вместо API Vertex AI Gemini ):

Настройки безопасности
- Удалены случаи использования неподдерживаемого метода SafetySetting.method .
Встроенные данные
- Удалены случаи использования неподдерживаемого объекта InlineDataPart.videoMetadata .

Dart

Никаких дополнительных изменений.

Единство

Поддержка Unity в " Vertex AI in Firebase " отсутствовала.

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Оставьте отзыв о вашем опыте использования Firebase AI Logic.

Переход на Firebase AI Logic SDKs из версии GA Vertex AI в Firebase SDKs Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Обзор шагов по миграции на SDK Firebase AI Logic .

Шаг 1 : Выберите лучшего поставщика "Gemini API" для вашего приложения.

Шаг 2 : Настройте свой проект Firebase, чтобы вы могли использовать API разработчика Gemini.

Шаг 3 : Обновите библиотеку, используемую в вашем приложении.

Быстрый

Kotlin

Java

Web

Dart

Единство

Шаг 4 : Обновите инициализацию в вашем приложении.

Быстрый

Kotlin

Java

Web

Dart

Единство

Шаг 5 : Обновите свой код в зависимости от используемых вами функций.

Быстрый

Kotlin

Java

Web

Dart

Единство

Переход на Firebase AI Logic SDKs из версии GA Vertex AI в Firebase SDKs