Переход на Firebase AI Logic SDK с Google AI client SDK

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Быстрый

Используйте Swift Package Manager для установки и управления зависимостями Firebase.

Библиотека Firebase AI Logic обеспечивает доступ к API для взаимодействия с моделями Gemini и Imagen . Библиотека включена в состав Firebase SDK для платформ Apple ( firebase-ios-sdk ).

Если вы уже используете Firebase, убедитесь, что ваш пакет Firebase — v11.13.0 или более поздней версии.

1. В Xcode откройте проект приложения и перейдите в меню Файл > Добавить зависимости пакета .

2. При появлении соответствующего запроса добавьте репозиторий Firebase Apple platform SDK:

   https://github.com/firebase/firebase-ios-sdk
   

3. Выберите последнюю версию SDK.

4. Выберите библиотеку FirebaseAI .

По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Kotlin

Firebase AI Logic SDK для Android ( firebase-ai ) предоставляет доступ к API для взаимодействия с моделями Gemini и Imagen .

В файле Gradle вашего модуля (уровня приложения) (например, <project>/<app-module>/build.gradle.kts ) добавьте зависимость для библиотеки Firebase AI Logic для Android. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотеки.

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:33.13.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")
}

Благодаря использованию Firebase Android BoM ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.

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

Java

Firebase AI Logic SDK для Android ( firebase-ai ) предоставляет доступ к API для взаимодействия с моделями Gemini и Imagen .

В файле Gradle вашего модуля (уровня приложения) (например, <project>/<app-module>/build.gradle.kts ) добавьте зависимость для библиотеки Firebase AI Logic для Android. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотеки.

Для Java вам необходимо добавить две дополнительные библиотеки.

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:33.13.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")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

Благодаря использованию Firebase Android BoM ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.

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

Web

Библиотека Firebase AI Logic обеспечивает доступ к API для взаимодействия с моделями Gemini и Imagen . Библиотека включена в состав Firebase JavaScript SDK for Web.

1. Установите Firebase JS SDK для Web с помощью npm:

   npm install firebase
   

2. Инициализируйте Firebase в вашем приложении:

   import { initializeApp } from "firebase/app";
   
   // 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);
   

Dart

Плагин Firebase AI Logic для Flutter ( firebase_ai ) обеспечивает доступ к API для взаимодействия с моделями Gemini и Imagen .

1. Из каталога проекта Flutter выполните следующую команду, чтобы установить основной плагин и плагин Firebase AI Logic :

   flutter pub add firebase_core && flutter pub add firebase_ai
   

2. В файле lib/main.dart импортируйте основной плагин Firebase, плагин Firebase AI Logic и файл конфигурации, который вы сгенерировали ранее:

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

3. Также в файле lib/main.dart инициализируйте Firebase с помощью объекта DefaultFirebaseOptions , экспортированного файлом конфигурации:

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

4. Перестройте свое приложение Flutter:

   flutter run
   

Единство

Поддержка Unity не была доступна в клиентских SDK Google AI .

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

Быстрый

Удалить старую библиотеку:

1. В Xcode откройте проект приложения и перейдите на панель «Зависимости пакетов» .

2. Выберите пакет generative-ai-swift из списка зависимостей пакетов.

3. Нажмите кнопку - в нижней части списка и нажмите «Удалить» для подтверждения.

Kotlin

dependencies {
    implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Java

dependencies {
    implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Web

// BEFORE
import { initializeApp } from "firebase/app";
import { GoogleGenerativeAI } from "@google/generative-ai";

Dart

Удалить старый пакет:
flutter pub remove google_generative_ai

Единство

Поддержка Unity не была доступна в клиентских SDK Google AI .

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

Быстрый

// BEFORE
import GoogleGenerativeAI

let model = GenerativeModel(name: "MODEL_NAME", apiKey: APIKey.default)

// AFTER
import FirebaseAI

// 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.0-flash")

Kotlin

// BEFORE
import com.google.ai.client.generativeai.Chat
import com.google.ai.client.generativeai.type.Content
import com.google.ai.client.generativeai.java.GenerativeModuleFutures

...

val generativeModel = GenerativeModel(modelName = "MODEL_NAME",
  // Access your API key as a Build Configuration variable
  apiKey = BuildConfig.apiKey
)

// AFTER
import com.google.firebase.Firebase
import com.google.firebase.ai.ai
import com.google.firebase.ai.type.GenerativeBackend

...

// 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.0-flash")

Java

// BEFORE
import com.google.ai.client.generativeai.Chat;
import com.google.ai.client.generativeai.type.Content;
import com.google.ai.client.generativeai.java.GenerativeModuleFutures;

...

GenerativeModel gm = new GenerativeModel("MODEL_NAME",
  // Access your API key as a Build Configuration variable
  BuildConfig.apiKey
);

GenerativeModelFutures model = GenerativeModelFutures.from(gm);

// AFTER
import com.google.firebase.ai.FirebaseAI;
import com.google.firebase.ai.GenerativeModel;
import com.google.firebase.ai.java.GenerativeModelFutures;
import com.google.firebase.ai.type.GenerativeBackend;

...

// 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.0-flash");

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

Web

// BEFORE
import { GoogleGenerativeAI } from "@google/generative-ai";

// Fetch your API_KEY and access your API
const API_KEY = "...";
const genAI = new GoogleGenerativeAI(API_KEY);

...

const model = genAI.getGenerativeModel({ model: "MODEL_NAME"});

// AFTER
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.0-flash" });

Dart

// BEFORE
import 'package:google_generative_ai/google_generative_ai.dart';

final apiKey = Platform.environment['API_KEY'];
if (apiKey == null) {
print('No \$API_KEY environment variable');
exit(1);
}

final model = GenerativeModel(model: 'MODEL_NAME', apiKey: apiKey);

// AFTER
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.0-flash');

Единство

Поддержка Unity не была доступна в клиентских SDK Google AI .

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

Быстрый

• Перечисления

  • Заменено большинство типов enum на struct со статическими переменными. Это изменение обеспечивает большую гибкость для развития API в обратно совместимом виде. При использовании операторов switch теперь необходимо включать случай default: для охвата неизвестных или необработанных значений, включая новые значения, которые будут добавлены в SDK в будущем.

  • Перечисление BlockThreshold переименовано в HarmBlockThreshold ; теперь этот тип является struct .

  • Удалены unknown и unspecified случаи из следующих перечислений (теперь struct ): HarmCategory , HarmBlockThreshold , HarmProbability , BlockReason и FinishReason .

  • Заменил перечисление ModelContent.Part протоколом с именем Part , чтобы разрешить добавление новых типов обратно совместимым способом. Это изменение более подробно описано в разделе Части контента .

• Части контента

  • Удален протокол ThrowingPartsRepresentable и упрощены инициализаторы для ModelContent , чтобы избежать случайных ошибок компилятора. Изображения, которые не кодируются должным образом, все равно будут выдавать ошибки при использовании в generateContent .

  • Заменены случаи ModelContent.Part следующими struct типами, соответствующими протоколу Part :

    • .text в TextPart
    • .data в InlineDataPart
    • .fileData в FileDataPart
    • .functionCall в FunctionCallPart
    • .functionResponse на FunctionResponsePart

• Категория вреда

  • Изменено HarmCategory , чтобы больше не быть вложенным в тип SafetySetting . Если вы ссылаетесь на него как на SafetySetting.HarmCategory , это можно заменить на HarmCategory .

• Обратная связь по безопасности

  • Удален тип SafetyFeedback , так как он не использовался ни в одном из ответов.

• Метаданные цитирования

  • Свойство citationSources в CitationMetadata переименовано в citations .

• Всего оплачиваемых символов

  • Свойство totalBillableCharacters в CountTokensResponse изменено на необязательное для отражения ситуаций, когда символы не отправляются.

• Ответ кандидата

  • CandidateResponse переименован в Candidate для соответствия другим платформам.

• Конфигурация генерации

  • Изменил публичные свойства GenerationConfig на internal . Все они остаются настраиваемыми в инициализаторе.

Kotlin

• Перечисления

  • Заменены enum классы и sealed классы на обычные классы. Это изменение обеспечивает большую гибкость для развития API в обратно совместимом режиме.

  • Перечисление BlockThreshold переименовано в HarmBlockThreshold .

  • Удалены значения из следующих перечислений: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason и FinishReason .

• Методы Blob

  • Переименованы все методы, включающие Blob в свое имя, чтобы вместо этого использовать InlineData .

• Настройки безопасности

  • method поля изменен так, чтобы он допускал значение NULL.

• Продолжительность класса

  • Удалены все использования класса Duration из Kotlin и заменены на long . Это изменение обеспечивает лучшую совместимость с Java.

• Метаданные цитирования

  • Обернул все поля, ранее объявленные в CitationMetadata , в новый класс под названием Citation . Ссылки можно найти в списке под названием citations в CitationMetadata . Это изменение позволяет лучше согласовывать типы на разных платформах.

• Подсчет жетонов

  • Поле totalBillableCharacters изменено на допускающее значение NULL.

• Всего оплачиваемых символов

  • Свойство totalBillableCharacters в CountTokensResponse изменено на необязательное для отражения ситуаций, когда символы не отправляются.

• Создание модели

  • Параметр requestOptions перенесен в конец списка параметров для соответствия другим платформам.

Java

• Перечисления

  • Заменены enum классы и sealed классы на обычные классы. Это изменение обеспечивает большую гибкость для развития API в обратно совместимом режиме.

  • Перечисление BlockThreshold переименовано в HarmBlockThreshold .

  • Удалены значения из следующих перечислений: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason и FinishReason .

• Методы Blob

  • Переименованы все методы, включающие Blob в свое имя, чтобы вместо этого использовать InlineData .

• Настройки безопасности

  • method поля изменен так, чтобы он допускал значение NULL.

• Продолжительность класса

  • Удалены все использования класса Duration из Kotlin и заменены на long . Это изменение обеспечивает лучшую совместимость с Java.

• Метаданные цитирования

  • Обернул все поля, ранее объявленные в CitationMetadata , в новый класс под названием Citation . Ссылки можно найти в списке под названием citations в CitationMetadata . Это изменение позволяет лучше согласовывать типы на разных платформах.

• Подсчет жетонов

  • Поле totalBillableCharacters изменено на допускающее значение NULL.

• Всего оплачиваемых символов

  • Свойство totalBillableCharacters в CountTokensResponse изменено на необязательное для отражения ситуаций, когда символы не отправляются.

• Создание модели

  • Параметр requestOptions перенесен в конец списка параметров для соответствия другим платформам.

Web

Обратите внимание, что Google AI client SDK для JavaScript претерпел множество изменений с тех пор, как от него отделились Firebase AI Logic client SDK. Ниже приведен список некоторых потенциальных изменений, которые вам, возможно, придется учесть при переходе на Firebase AI Logic client SDK.

• Перечисления

  • Удалены значения из следующих перечислений: HarmCategory , BlockThreshold , HarmProbability , HarmSeverity , BlockReason и FinishReason .

• Причина блокировки

  • Изменено blockReason в PromptFeedback на необязательное.

• Поиск заземления

  • Удалены все использования этой функции, поскольку она пока не поддерживается в Firebase AI Logic SDK.

• Ошибки

  • Удалены все использования GoogleGenerativeAIError и при необходимости перемещены в AIError .

Dart

• Перечисления

  • Удалены значения из следующих перечислений: HarmCategory , HarmProbability , BlockReason и FinishReason .

• Часть данных

  • DataPart переименован в InlineDataPart , а функция static data — в inlineData для соответствия другим платформам.

• Запросить варианты

  • Удален RequestOptions , поскольку timeout не работал. Он будет добавлен снова в ближайшем будущем, но будет перемещен в тип GenerativeModel для соответствия другим платформам.

• Остановочные последовательности

  • Параметр stopSequences в GenerationConfig изменен на необязательный и по умолчанию имеет значение null вместо пустого массива.

• Цитаты

  • Свойство citationSources переименовано в citations в CitationMetadata . Тип CitationSource переименован в Citation для соответствия другим платформам.

• Ненужные публичные типы, методы и свойства

  • Удалены следующие типы, методы и свойства, которые были непреднамеренно раскрыты: defaultTimeout , CountTokensResponseFields , parseCountTokensResponse , parseEmbedContentResponse , parseGenerateContentResponse , parseContent , BatchEmbedContentsResponse , ContentEmbedding , EmbedContentRequest и EmbedContentResponse .

• Подсчет жетонов

  • Удалены дополнительные поля из функции countTokens , которые больше не нужны. Необходимо только contents .

• Создание модели

  • Параметр systemInstruction перенесен в конец списка параметров для соответствия другим платформам.

• Встраиваемая функциональность

  • Из модели удалены неподдерживаемые функции встраивания ( embedContent и batchEmbedContents ).

Единство

Поддержка Unity не была доступна в клиентских SDK Google AI .

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