Переход на Firebase AI Logic SDKs из предварительной версии Vertex AI в Firebase SDKs

Быстрый

1. В Xcode, открыв проект приложения, обновите пакет Firebase до версии 11.13.0 или более поздней, используя один из следующих вариантов:

   • Вариант 1 : Обновить все пакеты: Перейдите в меню Файл > Пакеты > Обновить до последних версий пакетов .

   • Вариант 2 : Обновите Firebase по отдельности: Перейдите к пакету Firebase в разделе « Зависимости пакета» . Щелкните правой кнопкой мыши по пакету Firebase и выберите «Обновить пакет» .

2. Убедитесь, что в списке необходимых пакетов Firebase отображается версия 11.13.0 или более поздняя. Если это не так, проверьте, позволяют ли указанные вами требования к пакету обновить его до версии 11.13.0 или более поздней.

3. В редакторе проектов выберите целевой объект вашего приложения, а затем перейдите в раздел «Фреймворки, библиотеки и встроенный контент» .

4. Добавьте новую библиотеку: выберите кнопку «+» , а затем добавьте FirebaseAI из пакета Firebase.

5. После завершения миграции вашего приложения (см. остальные разделы этого руководства) обязательно удалите старую библиотеку:
   Выберите FirebaseVertexAI-Preview , а затем нажмите кнопку — .

Kotlin

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

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

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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")
   }

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

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

Java

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

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

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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")
   }

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

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

Web

1. Получите последнюю версию Firebase JS SDK для веб-разработки с помощью npm:

   npm i firebase@latest

   ИЛИ

   yarn add firebase@latest

2. Везде, где вы импортировали библиотеку, обновите операторы импорта, используя firebase/ai вместо этого.

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

   // BEFORE
   import { initializeApp } from "firebase/app";
   import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. Для обновления и добавления пакета firebase_ai в файл pubspec.yaml выполните следующую команду из каталога вашего проекта Flutter:

   flutter pub add firebase_ai

2. Пересоберите свой проект Flutter:

   flutter run

3. После завершения миграции вашего приложения (см. остальные разделы этого руководства) обязательно удалите старый пакет:

   flutter pub remove firebase_vertexai

Единство

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

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

Быстрый

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-3.7-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-3.7-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-3.7-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-3.7-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-3.7-flash');

Единство

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

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

Быстрый

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

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

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

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

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

• Содержание

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

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

    • .text to TextPart
    • .data to InlineDataPart
    • .fileData to FileDataPart
    • .functionCall to FunctionCallPart
    • .functionResponse to 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 перемещен в конец списка параметров для соответствия требованиям других платформ.

• Live API

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

  • Переименована LiveGenerationConfig.setResponseModalities в LiveGenerationConfig.setResponseModality .

  • Класс LiveContentResponse.Status был удалён, и вместо него поля статуса вложены в свойства класса LiveContentResponse .

  • Класс LiveContentResponse был удален, и вместо него предоставлены подклассы LiveServerMessage , которые соответствуют ответам от модели.

  • Изменено значение в LiveModelFutures.connect : теперь он возвращает ListenableFuture<LiveSessionFutures> вместо ListenableFuture<LiveSession> .

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 перемещен в конец списка параметров для соответствия требованиям других платформ.

• Live API

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

  • Переименована LiveGenerationConfig.setResponseModalities в LiveGenerationConfig.setResponseModality .

  • Класс LiveContentResponse.Status был удалён, и вместо него поля статуса вложены в свойства класса LiveContentResponse .

  • Класс LiveContentResponse был удален, и вместо него предоставлены подклассы LiveServerMessage , которые соответствуют ответам от модели.

  • Изменено значение в LiveModelFutures.connect : теперь он возвращает ListenableFuture<LiveSessionFutures> вместо ListenableFuture<LiveSession> .

• Изменены различные методы Java-конструктора, теперь они корректно возвращают экземпляр своего класса, а не void .

Web

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

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

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

  • Изменено blockReason в PromptFeedback , теперь он является необязательным.

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

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

  • Удалены случаи использования неподдерживаемого метода SafetySetting.method .

• Встроенные данные

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

Dart

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

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

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

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

• Варианты запроса

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

• Стоп-последовательности

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

• Цитаты

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

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

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

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

  • Из функции countTokens удалены лишние поля, которые больше не нужны. Требуется только contents .

• Создание экземпляра модели

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

• Функциональность встраивания

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

Единство

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

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

Быстрый

1. В Xcode, открыв проект приложения, обновите пакет Firebase до версии 11.13.0 или более поздней, используя один из следующих вариантов:

   • Вариант 1 : Обновить все пакеты: Перейдите в меню Файл > Пакеты > Обновить до последних версий пакетов .

   • Вариант 2 : Обновите Firebase по отдельности: Перейдите к пакету Firebase в разделе « Зависимости пакета» . Щелкните правой кнопкой мыши по пакету Firebase и выберите «Обновить пакет» .

2. Убедитесь, что в списке необходимых пакетов Firebase отображается версия 11.13.0 или более поздняя. Если это не так, проверьте, позволяют ли указанные вами требования к пакету обновить его до версии 11.13.0 или более поздней.

3. В редакторе проектов выберите целевой объект вашего приложения, а затем перейдите в раздел «Фреймворки, библиотеки и встроенный контент» .

4. Добавьте новую библиотеку: выберите кнопку «+» , а затем добавьте FirebaseAI из пакета Firebase.

5. После завершения миграции вашего приложения (см. остальные разделы этого руководства) обязательно удалите старую библиотеку:
   Выберите FirebaseVertexAI-Preview , а затем нажмите кнопку — .

Kotlin

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

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

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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")
   }

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

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

Java

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

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

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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")
   }

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

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

Web

1. Получите последнюю версию Firebase JS SDK для веб-разработки с помощью npm:

   npm i firebase@latest

   ИЛИ

   yarn add firebase@latest

2. Везде, где вы импортировали библиотеку, обновите операторы импорта, используя firebase/ai вместо этого.

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

   // BEFORE
   import { initializeApp } from "firebase/app";
   import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. Для обновления и добавления пакета firebase_ai в файл pubspec.yaml выполните следующую команду из каталога вашего проекта Flutter:

   flutter pub add firebase_ai

2. Пересоберите свой проект Flutter:

   flutter run

3. После завершения миграции вашего приложения (см. остальные разделы этого руководства) обязательно удалите старый пакет:

   flutter pub remove firebase_vertexai

Единство

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

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

Быстрый

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-3.7-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-3.7-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-3.7-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-3.7-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-3.7-flash');

Единство

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

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

Быстрый

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

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

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

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

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

• Содержание

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

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

    • .text to TextPart
    • .data to InlineDataPart
    • .fileData to FileDataPart
    • .functionCall to FunctionCallPart
    • .functionResponse to 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 перемещен в конец списка параметров для соответствия требованиям других платформ.

• Live API

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

  • Переименована LiveGenerationConfig.setResponseModalities в LiveGenerationConfig.setResponseModality .

  • Класс LiveContentResponse.Status был удалён, и вместо него поля статуса вложены в свойства класса LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

Java

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

  • Replaced enum classes and sealed classes with regular classes. This change allows more flexibility for evolving the API in a backward compatible way.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold .

  • Removed values from the following enumerations: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Blob methods

  • Renamed all methods that included Blob as part of their name to use InlineData instead.

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

  • Changed the field method to be nullable.

• Duration class

  • Removed all usages of Kotlin's Duration class, and replaced it with long . This change provides better interoperability with Java.

• Citation metadata

  • Wrapped all the fields previously declared in CitationMetadata into a new class called Citation . Citations can be found in the list called citations in CitationMetadata . This change allows better alignment of types across platforms.

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

  • Changed the field totalBillableCharacters to be nullable.

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Instantiating a model

  • Moved the requestOptions parameter to the end of the parameter list to align with other platforms.

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

• Changed various Java builder methods to now correctly return the instance of their class, instead of void .

Web

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

  • Removed values from the following enumerations: HarmCategory , BlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

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

  • Changed blockReason in PromptFeedback to be optional.

Changes required only if you're starting to use the Gemini Developer API (instead of the Agent Platform Gemini API (formerly Vertex AI) ):

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

  • Removed usages of the unsupported SafetySetting.method .

• Inline data

  • Removed usages of the unsupported InlineDataPart.videoMetadata .

Dart

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

  • Removed values from the following enumerations: HarmCategory , HarmProbability , BlockReason , and FinishReason .

• Data part

  • Renamed DataPart to InlineDataPart , and the static data function to inlineData to align with other platforms.

• Request options

  • Removed RequestOptions since timeout wasn't functional. It will be re-added in the near future, but it will be moved to the GenerativeModel type to match other platforms.

• Стоп-последовательности

  • Changed the stopSequences parameter in GenerationConfig to be optional and to default to null instead of an empty array.

• Цитаты

  • Renamed the citationSources property to citations in CitationMetadata . The CitationSource type was renamed to Citation to match other platforms.

• Unnecessary public types, methods, and properties

  • Removed the following types, methods, and properties which were unintentionally exposed: defaultTimeout , CountTokensResponseFields , parseCountTokensResponse , parseEmbedContentResponse , parseGenerateContentResponse , parseContent , BatchEmbedContentsResponse , ContentEmbedding , EmbedContentRequest , and EmbedContentResponse .

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

  • Removed extra fields from the countTokens function that are no longer necessary. Only contents is needed.

• Instantiating a model

  • Moved the systemInstruction parameter to the end of the parameter list to align with other platforms.

• Embedding functionality

  • Removed unsupported embedding functionality ( embedContent and batchEmbedContents ) from the model.

Единство

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

Быстрый

1. In Xcode, with your app project open, update your Firebase package to v11.13.0 or later using one of the following options:

   • Option 1 : Update all packages: Navigate to File > Packages > Update to Latest Package Versions .

   • Option 2 : Update Firebase individually: Navigate to the Firebase package in the section called Package Dependencies . Right-click on the Firebase package, and then select Update Package .

2. Make sure that the Firebase package now shows v11.13.0 or later. If it doesn't, verify that your specified Package Requirements allow updating to v11.13.0 or later.

3. Select your app's target in the Project Editor, and then navigate to the Frameworks, Libraries, and Embedded Content section.

4. Add the new library: Select the + button, and then add FirebaseAI from the Firebase package.

5. After you've finished migrating your app (see the remaining sections in this guide), make sure to remove the old library:
   Select FirebaseVertexAI-Preview , and then press the — button.

Kotlin

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), replace old dependencies (as applicable) with the following.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old dependency.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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")
   }

2. Sync your Android project with Gradle files.

Note that if you choose to not use the Firebase Android BoM , then just add the dependency for the firebase-ai library and accept the latest version that's suggested by Android Studio.

Java

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), replace old dependencies (as applicable) with the following.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old dependency.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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")
   }

2. Sync your Android project with Gradle files.

Note that if you choose to not use the Firebase Android BoM , then just add the dependency for the firebase-ai library and accept the latest version that's suggested by Android Studio.

Web

1. Get the latest version of the Firebase JS SDK for Web using npm:

   npm i firebase@latest

   ИЛИ

   yarn add firebase@latest

2. Wherever you've imported the library, update your import statements to use firebase/ai instead.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old imports.

   // BEFORE
   import { initializeApp } from "firebase/app";
   import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. Update to the use the firebase_ai package in your pubspec.yaml file by running the following command from your Flutter project directory:

   flutter pub add firebase_ai

2. Rebuild your Flutter project:

   flutter run

3. After you've finished migrating your app (see the remaining sections in this guide), make sure to delete the old package:

   flutter pub remove firebase_vertexai

Единство

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

Быстрый

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-3.7-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-3.7-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-3.7-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-3.7-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-3.7-flash');

Единство

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

Быстрый

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

  • Replaced most enum types with struct s with static variables. This change allows more flexibility for evolving the API in a backward-compatible way. When using switch statements, you must now include a default: case to cover unknown or unhandled values, including new values that are added to the SDK in the future.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold ; this type is now a struct .

  • Removed unknown and unspecified cases from the following enumerations (now struct s): HarmCategory , HarmBlockThreshold , HarmProbability , BlockReason , and FinishReason .

  • Replaced the enumeration ModelContent.Part with a protocol named Part to allow new types to be added in a backward-compatible way. This change is described in greater detail in the Content parts section.

• Content parts

  • Removed the ThrowingPartsRepresentable protocol, and simplified the initializers for ModelContent to avoid occasional compiler errors. Images that don't encode properly will still throw errors when being used in generateContent .

  • Replaced the ModelContent.Part cases with the following struct types conforming to the Part protocol:

    • .text to TextPart
    • .data to InlineDataPart
    • .fileData to FileDataPart
    • .functionCall to FunctionCallPart
    • .functionResponse to FunctionResponsePart

• Harm category

  • Changed the HarmCategory to no longer be nested in the SafetySetting type. If you're referring to it as SafetySetting.HarmCategory , that can be replaced with HarmCategory .

• Safety feedback

  • Removed the SafetyFeedback type, since it wasn't used in any of the responses.

• Citation metadata

  • Renamed the citationSources property to citations in CitationMetadata .

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Candidate response

  • Renamed CandidateResponse to Candidate to match other platforms.

• Generation configuration

  • Changed the public properties of GenerationConfig to internal . They all remain configurable in the initializer.

Kotlin

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

  • Replaced enum classes and sealed classes with regular classes. This change allows more flexibility for evolving the API in a backward compatible way.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold .

  • Removed values from the following enumerations: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Blob methods

  • Renamed all methods that included Blob as part of their name to use InlineData instead.

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

  • Changed the field method to be nullable.

• Duration class

  • Removed all usages of Kotlin's Duration class, and replaced it with long . This change provides better interoperability with Java.

• Citation metadata

  • Wrapped all the fields previously declared in CitationMetadata into a new class called Citation . Citations can be found in the list called citations in CitationMetadata . This change allows better alignment of types across platforms.

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

  • Changed the field totalBillableCharacters to be nullable.

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Instantiating a model

  • Moved the requestOptions parameter to the end of the parameter list to align with other platforms.

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

Java

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

  • Replaced enum classes and sealed classes with regular classes. This change allows more flexibility for evolving the API in a backward compatible way.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold .

  • Removed values from the following enumerations: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Blob methods

  • Renamed all methods that included Blob as part of their name to use InlineData instead.

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

  • Changed the field method to be nullable.

• Duration class

  • Removed all usages of Kotlin's Duration class, and replaced it with long . This change provides better interoperability with Java.

• Citation metadata

  • Wrapped all the fields previously declared in CitationMetadata into a new class called Citation . Citations can be found in the list called citations in CitationMetadata . This change allows better alignment of types across platforms.

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

  • Changed the field totalBillableCharacters to be nullable.

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Instantiating a model

  • Moved the requestOptions parameter to the end of the parameter list to align with other platforms.

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

• Changed various Java builder methods to now correctly return the instance of their class, instead of void .

Web

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

  • Removed values from the following enumerations: HarmCategory , BlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

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

  • Changed blockReason in PromptFeedback to be optional.

Changes required only if you're starting to use the Gemini Developer API (instead of the Agent Platform Gemini API (formerly Vertex AI) ):

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

  • Removed usages of the unsupported SafetySetting.method .

• Inline data

  • Removed usages of the unsupported InlineDataPart.videoMetadata .

Dart

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

  • Removed values from the following enumerations: HarmCategory , HarmProbability , BlockReason , and FinishReason .

• Data part

  • Renamed DataPart to InlineDataPart , and the static data function to inlineData to align with other platforms.

• Request options

  • Removed RequestOptions since timeout wasn't functional. It will be re-added in the near future, but it will be moved to the GenerativeModel type to match other platforms.

• Стоп-последовательности

  • Changed the stopSequences parameter in GenerationConfig to be optional and to default to null instead of an empty array.

• Цитаты

  • Renamed the citationSources property to citations in CitationMetadata . The CitationSource type was renamed to Citation to match other platforms.

• Unnecessary public types, methods, and properties

  • Removed the following types, methods, and properties which were unintentionally exposed: defaultTimeout , CountTokensResponseFields , parseCountTokensResponse , parseEmbedContentResponse , parseGenerateContentResponse , parseContent , BatchEmbedContentsResponse , ContentEmbedding , EmbedContentRequest , and EmbedContentResponse .

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

  • Removed extra fields from the countTokens function that are no longer necessary. Only contents is needed.

• Instantiating a model

  • Moved the systemInstruction parameter to the end of the parameter list to align with other platforms.

• Embedding functionality

  • Removed unsupported embedding functionality ( embedContent and batchEmbedContents ) from the model.

Единство

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

Быстрый

1. In Xcode, with your app project open, update your Firebase package to v11.13.0 or later using one of the following options:

   • Option 1 : Update all packages: Navigate to File > Packages > Update to Latest Package Versions .

   • Option 2 : Update Firebase individually: Navigate to the Firebase package in the section called Package Dependencies . Right-click on the Firebase package, and then select Update Package .

2. Make sure that the Firebase package now shows v11.13.0 or later. If it doesn't, verify that your specified Package Requirements allow updating to v11.13.0 or later.

3. Select your app's target in the Project Editor, and then navigate to the Frameworks, Libraries, and Embedded Content section.

4. Add the new library: Select the + button, and then add FirebaseAI from the Firebase package.

5. After you've finished migrating your app (see the remaining sections in this guide), make sure to remove the old library:
   Select FirebaseVertexAI-Preview , and then press the — button.

Kotlin

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), replace old dependencies (as applicable) with the following.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old dependency.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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")
   }

2. Sync your Android project with Gradle files.

Note that if you choose to not use the Firebase Android BoM , then just add the dependency for the firebase-ai library and accept the latest version that's suggested by Android Studio.

Java

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), replace old dependencies (as applicable) with the following.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old dependency.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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")
   }

2. Sync your Android project with Gradle files.

Note that if you choose to not use the Firebase Android BoM , then just add the dependency for the firebase-ai library and accept the latest version that's suggested by Android Studio.

Web

1. Get the latest version of the Firebase JS SDK for Web using npm:

   npm i firebase@latest

   ИЛИ

   yarn add firebase@latest

2. Wherever you've imported the library, update your import statements to use firebase/ai instead.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old imports.

   // BEFORE
   import { initializeApp } from "firebase/app";
   import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. Update to the use the firebase_ai package in your pubspec.yaml file by running the following command from your Flutter project directory:

   flutter pub add firebase_ai

2. Rebuild your Flutter project:

   flutter run

3. After you've finished migrating your app (see the remaining sections in this guide), make sure to delete the old package:

   flutter pub remove firebase_vertexai

Единство

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

Быстрый

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-3.7-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-3.7-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-3.7-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-3.7-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-3.7-flash');

Единство

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

Быстрый

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

  • Replaced most enum types with struct s with static variables. This change allows more flexibility for evolving the API in a backward-compatible way. When using switch statements, you must now include a default: case to cover unknown or unhandled values, including new values that are added to the SDK in the future.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold ; this type is now a struct .

  • Removed unknown and unspecified cases from the following enumerations (now struct s): HarmCategory , HarmBlockThreshold , HarmProbability , BlockReason , and FinishReason .

  • Replaced the enumeration ModelContent.Part with a protocol named Part to allow new types to be added in a backward-compatible way. This change is described in greater detail in the Content parts section.

• Content parts

  • Removed the ThrowingPartsRepresentable protocol, and simplified the initializers for ModelContent to avoid occasional compiler errors. Images that don't encode properly will still throw errors when being used in generateContent .

  • Replaced the ModelContent.Part cases with the following struct types conforming to the Part protocol:

    • .text to TextPart
    • .data to InlineDataPart
    • .fileData to FileDataPart
    • .functionCall to FunctionCallPart
    • .functionResponse to FunctionResponsePart

• Harm category

  • Changed the HarmCategory to no longer be nested in the SafetySetting type. If you're referring to it as SafetySetting.HarmCategory , that can be replaced with HarmCategory .

• Safety feedback

  • Removed the SafetyFeedback type, since it wasn't used in any of the responses.

• Citation metadata

  • Renamed the citationSources property to citations in CitationMetadata .

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Candidate response

  • Renamed CandidateResponse to Candidate to match other platforms.

• Generation configuration

  • Changed the public properties of GenerationConfig to internal . They all remain configurable in the initializer.

Kotlin

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

  • Replaced enum classes and sealed classes with regular classes. This change allows more flexibility for evolving the API in a backward compatible way.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold .

  • Removed values from the following enumerations: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Blob methods

  • Renamed all methods that included Blob as part of their name to use InlineData instead.

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

  • Changed the field method to be nullable.

• Duration class

  • Removed all usages of Kotlin's Duration class, and replaced it with long . This change provides better interoperability with Java.

• Citation metadata

  • Wrapped all the fields previously declared in CitationMetadata into a new class called Citation . Citations can be found in the list called citations in CitationMetadata . This change allows better alignment of types across platforms.

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

  • Changed the field totalBillableCharacters to be nullable.

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Instantiating a model

  • Moved the requestOptions parameter to the end of the parameter list to align with other platforms.

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

Java

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

  • Replaced enum classes and sealed classes with regular classes. This change allows more flexibility for evolving the API in a backward compatible way.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold .

  • Removed values from the following enumerations: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Blob methods

  • Renamed all methods that included Blob as part of their name to use InlineData instead.

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

  • Changed the field method to be nullable.

• Duration class

  • Removed all usages of Kotlin's Duration class, and replaced it with long . This change provides better interoperability with Java.

• Citation metadata

  • Wrapped all the fields previously declared in CitationMetadata into a new class called Citation . Citations can be found in the list called citations in CitationMetadata . This change allows better alignment of types across platforms.

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

  • Changed the field totalBillableCharacters to be nullable.

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Instantiating a model

  • Moved the requestOptions parameter to the end of the parameter list to align with other platforms.

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

• Changed various Java builder methods to now correctly return the instance of their class, instead of void .

Web

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

  • Removed values from the following enumerations: HarmCategory , BlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

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

  • Changed blockReason in PromptFeedback to be optional.

Changes required only if you're starting to use the Gemini Developer API (instead of the Agent Platform Gemini API (formerly Vertex AI) ):

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

  • Removed usages of the unsupported SafetySetting.method .

• Inline data

  • Removed usages of the unsupported InlineDataPart.videoMetadata .

Dart

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

  • Removed values from the following enumerations: HarmCategory , HarmProbability , BlockReason , and FinishReason .

• Data part

  • Renamed DataPart to InlineDataPart , and the static data function to inlineData to align with other platforms.

• Request options

  • Removed RequestOptions since timeout wasn't functional. It will be re-added in the near future, but it will be moved to the GenerativeModel type to match other platforms.

• Стоп-последовательности

  • Changed the stopSequences parameter in GenerationConfig to be optional and to default to null instead of an empty array.

• Цитаты

  • Renamed the citationSources property to citations in CitationMetadata . The CitationSource type was renamed to Citation to match other platforms.

• Unnecessary public types, methods, and properties

  • Removed the following types, methods, and properties which were unintentionally exposed: defaultTimeout , CountTokensResponseFields , parseCountTokensResponse , parseEmbedContentResponse , parseGenerateContentResponse , parseContent , BatchEmbedContentsResponse , ContentEmbedding , EmbedContentRequest , and EmbedContentResponse .

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

  • Removed extra fields from the countTokens function that are no longer necessary. Only contents is needed.

• Instantiating a model

  • Moved the systemInstruction parameter to the end of the parameter list to align with other platforms.

• Embedding functionality

  • Removed unsupported embedding functionality ( embedContent and batchEmbedContents ) from the model.

Единство

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .