Начните работу с API Gemini с помощью Firebase AI Logic SDK

Быстрый

В этом руководстве предполагается, что вы знакомы с использованием Xcode для разработки приложений для платформ Apple (например, iOS).

Убедитесь, что ваша среда разработки и приложение для платформ Apple соответствуют следующим требованиям:

• Xcode 26.2 или выше
• Ваше приложение предназначено для iOS 15 или выше, либо для macOS 12 или выше.

Kotlin

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

Убедитесь, что ваша среда разработки и Android-приложение соответствуют следующим требованиям:

• Android Studio (последняя версия)
• Ваше приложение ориентировано на API уровня 21 или выше.

Java

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

Убедитесь, что ваша среда разработки и Android-приложение соответствуют следующим требованиям:

• Android Studio (последняя версия)
• Ваше приложение ориентировано на API уровня 21 или выше.

Web

Данное руководство предполагает, что вы знакомы с использованием JavaScript для разработки веб-приложений. Данное руководство не зависит от используемого фреймворка.

Убедитесь, что ваша среда разработки и веб-приложение соответствуют следующим требованиям:

• (Необязательно) Node.js
• Современный веб-браузер

Dart

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

Убедитесь, что ваша среда разработки и приложение Flutter соответствуют следующим требованиям:

• Dart 3.2.0+

Единство

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

Убедитесь, что ваша среда разработки и игра Unity соответствуют следующим требованиям:

• Unity Editor 2021 LTS или более поздняя версия

Быстрый

Попробуйте приложение для быстрого запуска.

Воспользуйтесь приложением быстрого запуска, чтобы быстро протестировать SDK и увидеть полную реализацию различных вариантов использования. Или используйте приложение быстрого запуска, если у вас нет собственного приложения для платформ Apple. Для использования приложения быстрого запуска вам потребуется подключить его к проекту Firebase .

Перейдите в приложение «Быстрый запуск».

Посмотрите видеоурок

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

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

Посмотреть код приложения, в котором размещен видеоролик.

Kotlin

Попробуйте приложение для быстрого запуска.

Воспользуйтесь приложением быстрого запуска, чтобы быстро протестировать SDK и увидеть полную реализацию различных вариантов использования. Или используйте приложение быстрого запуска, если у вас нет собственного приложения для Android. Для использования приложения быстрого запуска вам потребуется подключить его к проекту Firebase .

Перейдите в приложение «Быстрый запуск».

Посмотрите видеоурок

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

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

Посмотреть код приложения, в котором размещен видеоролик.

Java

Попробуйте приложение для быстрого запуска.

Воспользуйтесь приложением быстрого запуска, чтобы быстро протестировать SDK и увидеть полную реализацию различных вариантов использования. Или используйте приложение быстрого запуска, если у вас нет собственного приложения для Android. Для использования приложения быстрого запуска вам потребуется подключить его к проекту Firebase .

Перейдите в приложение «Быстрый запуск».

Посмотрите видеоурок

В этом видео показано, как начать работу с Firebase AI Logic , создав реальное приложение для планирования питания на основе искусственного интеллекта, которое генерирует рецепты по текстовому запросу. ^*

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

Посмотреть код приложения, в котором размещен видеоролик.

^{* Это видео и приложение написаны на Kotlin, но они также могут помочь Java-разработчикам понять основы начала работы с Firebase AI Logic .}

Web

Попробуйте приложение для быстрого запуска.

Воспользуйтесь приложением быстрого запуска, чтобы быстро протестировать SDK и увидеть полную реализацию различных вариантов использования. Или используйте приложение быстрого запуска, если у вас нет собственного веб-приложения. Для использования приложения быстрого запуска вам потребуется подключить его к проекту Firebase .

Перейдите в приложение «Быстрый запуск».

Dart

Попробуйте приложение для быстрого запуска.

Воспользуйтесь приложением быстрого запуска, чтобы быстро протестировать SDK и увидеть полную реализацию различных вариантов использования. Или используйте приложение быстрого запуска, если у вас нет собственного приложения Flutter. Для использования приложения быстрого запуска вам потребуется подключить его к проекту Firebase .

Перейдите в приложение «Быстрый запуск».

Посмотрите видеоурок

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

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

Посмотреть код приложения, в котором размещен видеоролик.

Единство

Попробуйте приложение для быстрого запуска.

Воспользуйтесь приложением быстрого запуска, чтобы быстро опробовать SDK и увидеть полную реализацию различных вариантов использования. Или используйте приложение быстрого запуска, если у вас нет собственной игры на Unity. Для использования приложения быстрого запуска вам потребуется подключить его к проекту Firebase .

Перейдите в приложение «Быстрый запуск».

Быстрый

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

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

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

1. В Xcode, открыв проект приложения, перейдите в меню File > Add Package Dependencies .

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

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

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

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

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

Kotlin

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

В файле 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:34.15.0"))

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

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

dependencies {
  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:17.13.0")
  implementation("com.google.firebase:firebase-appcheck-debug:19.2.0")
}

Java

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

В файле 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:34.15.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

  // 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 dependencies for the Firebase AI Logic and App Check libraries
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:17.13.0")
  implementation("com.google.firebase:firebase-appcheck-debug:19.2.0")
}

Web

Библиотека Firebase AI Logic предоставляет доступ к API для взаимодействия с моделями Gemini . Библиотека входит в состав Firebase JavaScript SDK для веб-приложений.

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

   npm install firebase
   

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

   import { initializeApp } from "firebase/app";
   import { initializeAppCheck, DebugProvider } from "firebase/app-check";
   
   // 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 .

1. В каталоге вашего проекта Flutter выполните следующую команду для установки основного плагина и плагина Firebase AI Logic :

   flutter pub add firebase_ai firebase_app_check
   

2. В файле lib/main.dart импортируйте плагины Firebase AI Logic и App Check :

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

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

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

4. Пересоберите ваше Flutter-приложение:

   flutter run
   

Единство

1. Загрузите Firebase Unity SDK , затем распакуйте SDK в удобное для вас место.

   SDK Firebase Unity не привязан к конкретной платформе.

2. В открытом проекте Unity перейдите в Assets > Import Package > Custom Package .

3. Из извлеченного SDK выберите пакет FirebaseAI и пакет FirebaseAppCheck .

4. В окне «Импорт пакета Unity» нажмите «Импорт» .

Быстрый

Вот как использовать отладочный провайдер при интерактивном запуске приложения в симуляторе (например, во время локальной разработки):

1. В вашем проекте Xcode импортируйте FirebaseAppCheck и инициализируйте App Check с помощью фабрики отладочных провайдеров, прежде чем настраивать Firebase .

   import SwiftUI
   import FirebaseCore
   import FirebaseAppCheck
   
   @main
   struct YourApp: App {
     init() {
       let providerFactory = AppCheckDebugProviderFactory()
       AppCheck.setAppCheckProviderFactory(providerFactory)
       FirebaseApp.configure()
     }
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
   

2. Получите свой отладочный токен:

   1. Запустите приложение в симуляторе или на тестовом устройстве.

   2. Откройте консоль Xcode и найдите отладочный токен App Check . Например:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
      

   3. Скопируйте токен (например, 123a4567-b89c-12d3-e456-789012345678 ).

3. Зарегистрируйте свой отладочный токен в App Check :

   1. В консоли Firebase перейдите в раздел Безопасность > Проверка приложений > вкладка Приложения .

   2. Найдите своё приложение, нажмите на меню дополнительных элементов ( more_vert ), а затем выберите «Управление отладочными токенами» .

   3. Следуйте инструкциям на экране, чтобы зарегистрировать свой отладочный токен.

Подробную информацию о поставщике отладки (включая способы получения нового токена отладки) можно найти в официальной документации App Check .

Kotlin

Вот как использовать отладочный провайдер при интерактивном запуске приложения в эмуляторе (например, во время локальной разработки):

1. В отладочной сборке настройте App Check для использования фабрики поставщиков отладки:

   Firebase.initialize(context = this)
   Firebase.appCheck.installAppCheckProviderFactory(
       DebugAppCheckProviderFactory.getInstance(),
   )
   MainActivity.kt

2. Получите свой отладочный токен:

   1. Запустите приложение в эмуляторе или на тестовом устройстве.

   2. Найдите в логах отладочный токен App Check . Например:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. Скопируйте токен (например, 123a4567-b89c-12d3-e456-789012345678 ).

3. Зарегистрируйте свой отладочный токен в App Check :

   1. В консоли Firebase перейдите в раздел Безопасность > Проверка приложений > вкладка Приложения .

   2. Найдите своё приложение, нажмите на меню дополнительных элементов ( more_vert ), а затем выберите «Управление отладочными токенами» .

   3. Следуйте инструкциям на экране, чтобы зарегистрировать свой отладочный токен.

Подробную информацию о поставщике отладки (включая способы получения нового токена отладки) можно найти в официальной документации App Check .

Java

Вот как использовать отладочный провайдер при интерактивном запуске приложения в эмуляторе (например, во время локальной разработки):

1. В отладочной сборке настройте App Check для использования фабрики поставщиков отладки:

   FirebaseApp.initializeApp(/*context=*/ this);
   FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
   firebaseAppCheck.installAppCheckProviderFactory(
           DebugAppCheckProviderFactory.getInstance());
   MainActivity.java

2. Получите свой отладочный токен:

   1. Запустите приложение в эмуляторе или на тестовом устройстве.

   2. Найдите в логах отладочный токен App Check . Например:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. Скопируйте токен (например, 123a4567-b89c-12d3-e456-789012345678 ).

3. Зарегистрируйте свой отладочный токен в App Check :

   1. В консоли Firebase перейдите в раздел Безопасность > Проверка приложений > вкладка Приложения .

   2. Найдите своё приложение, нажмите на меню дополнительных элементов ( more_vert ), а затем выберите «Управление отладочными токенами» .

   3. Следуйте инструкциям на экране, чтобы зарегистрировать свой отладочный токен.

Подробную информацию о поставщике отладки (включая способы получения нового токена отладки) можно найти в официальной документации App Check .

Web

Вот как использовать отладочный провайдер при интерактивном запуске приложения с localhost (например, во время локальной разработки):

1. В отладочной сборке включите режим отладки, установив параметр self.FIREBASE_APPCHECK_DEBUG_TOKEN в true перед инициализацией App Check . Например:

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   initializeAppCheck(app, { /* App Check options */ });
   

2. Откройте ваше веб-приложение локально и запустите инструменты разработчика в браузере. В консоли отладки вы увидите отладочный токен:

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
   You will need to safelist it in the Firebase console for it to work.
   

3. Зарегистрируйте свой отладочный токен в App Check :

   1. В консоли Firebase перейдите в раздел Безопасность > Проверка приложений > вкладка Приложения .

   2. Найдите своё приложение, нажмите на меню дополнительных элементов ( more_vert ), а затем выберите «Управление отладочными токенами» .

   3. Следуйте инструкциям на экране, чтобы зарегистрировать свой отладочный токен.

Подробную информацию о поставщике отладки (включая способы получения нового токена отладки) можно найти в официальной документации App Check .

Dart

Подробную информацию о поставщике отладки (включая способы получения нового токена отладки) можно найти в официальной документации App Check .

Единство

Вот как использовать отладочный провайдер при интерактивном запуске приложения в эмуляторе (например, во время локальной разработки):

1. В консоли Firebase создайте отладочный токен:

   1. В консоли Firebase перейдите в раздел Безопасность > Проверка приложений > вкладка Приложения .

   2. Найдите своё приложение, нажмите на меню дополнительных элементов ( more_vert ), а затем выберите «Управление отладочными токенами» .

   3. Следуйте инструкциям на экране, чтобы создать новый отладочный токен.

2. В код инициализации вашего приложения добавьте следующее:

   using Firebase.AppCheck;
   
   void InitializeFirebase() {
     // Configure the Debug Provider factory with your debug token.
     DebugAppCheckProviderFactory.Instance.SetDebugToken("YOUR_DEBUG_TOKEN");
   
     // Set App Check to use the debug provider factory
     FirebaseAppCheck.SetAppCheckProviderFactory(
       DebugAppCheckProviderFactory.Instance);
   
     // Proceed to initialize Firebase as normal
   }
   

Подробную информацию о поставщике отладки (включая способы получения нового токена отладки) можно найти в официальной документации App Check .

Быстрый

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.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-3.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-3.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-3.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-3.5-flash');

Единство

using Firebase;
using Firebase.AI;

// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.5-flash");

Быстрый

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

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")

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

// Provide a prompt that contains text
val prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
val response = model.generateContent(prompt)
print(response.text)

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

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

// Provide a prompt that contains text
Content prompt = new Content.Builder()
    .addText("Write a story about a magic backpack.")
    .build();

// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        System.out.println(resultText);
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);

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.5-flash" });

// Wrap in an async function so you can use await
async function run() {
  // Provide a prompt that contains text
  const prompt = "Write a story about a magic backpack."

  // To generate text output, call generateContent with the text input
  const result = await model.generateContent(prompt);

  const response = result.response;
  const text = response.text();
  console.log(text);
}

run();

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

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

Единство

using Firebase;
using Firebase.AI;

// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.5-flash");

// Provide a prompt that contains text
var prompt = "Write a story about a magic backpack.";

// To generate text output, call GenerateContentAsync with the text input
var response = await model.GenerateContentAsync(prompt);
UnityEngine.Debug.Log(response.Text ?? "No text in response.");