Начните работу с Gemini API, используя Vertex AI в Firebase SDK.Начните работу с Gemini API, используя Vertex AI в Firebase SDK.


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

  • При желании поэкспериментируйте с альтернативной версией API Gemini « Google AI ».
    Получите бесплатный доступ (в пределах ограничений и там, где это возможно) с помощью Google AI Studio и клиентских SDK Google AI . Эти SDK следует использовать для прототипирования только в мобильных и веб-приложениях.

    После того, как вы ознакомитесь с тем, как работает API Gemini , перейдите на наши Vertex AI в Firebase SDK (эта документация), которые имеют множество дополнительных функций, важных для мобильных и веб-приложений, таких как защита API от злоупотреблений с помощью Firebase App Check и поддержка больших медиафайлов в запросах .

  • При необходимости вызовите серверный API Vertex AI Gemini (например, с помощью Python, Node.js или Go).
    Используйте серверные Vertex AI SDK , Firebase Genkit или Firebase Extensions для Gemini API .

Предварительные условия

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

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

    • Android Studio (последняя версия)
    • Ваше Android-приложение должно быть ориентировано на уровень API 21 или выше.
  • (Необязательно) Ознакомьтесь с примером приложения.

    Загрузите образец приложения

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

Шаг 1. Настройте проект Firebase и подключите свое приложение к Firebase.

Если у вас уже есть проект Firebase и приложение, подключенное к Firebase

  1. В консоли Firebase перейдите на страницу Build with Gemini .

  2. Нажмите карточку Vertex AI в Firebase , чтобы запустить рабочий процесс, который поможет вам выполнить следующие задачи:

  3. Перейдите к следующему шагу этого руководства, чтобы добавить SDK в свое приложение.

Если у вас еще нет проекта Firebase и приложения, подключенного к Firebase

  1. Войдите в консоль Firebase .

  2. Нажмите «Создать проект» , а затем используйте любой из следующих вариантов:

    • Вариант 1. Создайте совершенно новый проект Firebase (и его базовый проект Google Cloud автоматически), введя новое имя проекта на первом этапе рабочего процесса «Создание проекта».

    • Вариант 2. «Добавьте Firebase» в существующий проект Google Cloud , выбрав имя проекта Google Cloud в раскрывающемся меню на первом этапе рабочего процесса «Создать проект».

    Обратите внимание: при появлении запроса вам не нужно настраивать Google Analytics для использования Vertex AI в Firebase SDK.

  3. В консоли Firebase перейдите на страницу Build with Gemini .

  4. Нажмите карточку Vertex AI в Firebase , чтобы запустить рабочий процесс, который поможет вам выполнить следующие задачи:

  1. Продолжайте выполнять рабочий процесс генеративного искусственного интеллекта консоли, чтобы подключить свое приложение к Firebase, который включает в себя следующие задачи:

    • Регистрация вашего приложения в проекте Firebase.

    • Добавление файла конфигурации Firebase ( google-services.json ) и Плагин google-services Gradle в ваше приложение.

  2. На следующих шагах этого руководства вы добавите Vertex AI в Firebase SDK в свое приложение и выполните необходимую инициализацию, необходимую для использования SDK и Gemini API .


Шаг 2. Добавьте SDK

После настройки проекта Firebase и подключения вашего приложения к Firebase (см. предыдущий шаг) вы теперь можете добавить Vertex AI в Firebase SDK в свое приложение.

Vertex AI в Firebase SDK для Android ( firebase-vertexai ) обеспечивает доступ к API Vertex AI Gemini .

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

KotlinJava
dependencies {
    // ... other androidx dependencies

    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.9.0"))

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

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

dependencies {
    // ... other androidx dependencies

    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.9.0"))

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

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

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

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

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

Шаг 3. Инициализируйте сервис Vertex AI и генеративную модель.

Прежде чем вы сможете выполнять какие-либо вызовы API, вам необходимо инициализировать службу Vertex AI и генеративную модель.

KotlinJava
Для Kotlin методы в этом SDK являются функциями приостановки, и их необходимо вызывать из области Coroutine .
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
val generativeModel = Firebase.vertexAI.generativeModel("gemini-2.0-flash")
Для Java методы потоковой передачи в этом SDK возвращают тип Publisher из библиотеки Reactive Streams .
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
GenerativeModel gm = FirebaseVertexAI.getInstance()
        .generativeModel("gemini-2.0-flash");

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

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

Шаг 4. Вызов API Vertex AI Gemini.

Теперь, когда вы подключили свое приложение к Firebase, добавили SDK и инициализировали сервис Vertex AI и генеративную модель, вы готовы вызвать API Vertex AI Gemini .

Вы можете использовать generateContent() для генерации текста из текстового запроса на подсказку:

KotlinJava
Для Kotlin методы в этом SDK являются функциями приостановки, и их необходимо вызывать из области Coroutine .
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
val generativeModel = Firebase.vertexAI.generativeModel("gemini-2.0-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 = generativeModel.generateContent(prompt)
print(response.text)
Для Java методы этого SDK возвращают ListenableFuture .
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
GenerativeModel gm = FirebaseVertexAI.getInstance()
        .generativeModel("gemini-2.0-flash");
GenerativeModelFutures model = GenerativeModelFutures.from(gm);

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

Что еще вы можете сделать?

Узнайте больше о моделях Gemini

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

Попробуйте другие возможности Gemini API

Узнайте, как контролировать создание контента

Вы также можете поэкспериментировать с подсказками и конфигурациями модели с помощью Vertex AI Studio .


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