API Vertex AI Gemini

Если вы новичок в API Gemini, рекомендуемым поставщиком API для разработчиков Android является Gemini Developer API . Но если у вас есть особые требования к местоположению данных или вы уже интегрированы в среду Vertex AI или Google Cloud, вы можете использовать Vertex AI Gemini API.

Начиная

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

Создайте проект Firebase и подключите ваше приложение к Firebase.

Когда вы будете готовы вызывать API из своего приложения, следуйте инструкциям в «Шаге 1» руководства по началу работы с Firebase AI Logic, чтобы настроить Firebase и включить необходимые API и сервисы.

Добавьте зависимости Gradle.

Добавьте следующие зависимости Gradle в модуль вашего приложения:

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")
}

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

Настройте отладочный провайдер App Check для локальной разработки.

Начиная с начала июля 2026 года, в рамках пошагового процесса настройки AI Logic в консоли Firebase, автоматически включается Firebase App Check для защиты API Gemini. Для локальной разработки необходимо настроить отладочный провайдер App Check таким образом, чтобы он обходил аттестацию, сохраняя при этом принудительное включение App Check.

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

   Котлин

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

   Java

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

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 .

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

Для начала создайте экземпляр GenerativeModel и укажите имя модели:

val model = Firebase.ai(backend = GenerativeBackend.vertexAI())
    .generativeModel("gemini-2.5-flash")
VertexAiGeminiApi.kt

GenerativeModel firebaseAI = FirebaseAI.getInstance(GenerativeBackend.vertexAI())
        .generativeModel("gemini-2.5-flash");

GenerativeModelFutures model = GenerativeModelFutures.from(firebaseAI);
VertexAiGeminiApiJava.java

В документации Firebase вы можете узнать больше о доступных моделях Gemini . Там же вы найдете информацию о настройке параметров модели .

Сгенерировать текст

Для генерации текстового ответа вызовите функцию generateContent() с вашим приглашением.

suspend fun generateText(model: GenerativeModel) {
    // Note: generateContent() is a suspend function, which integrates well
    // with existing Kotlin code.
    val response = model.generateContent("Write a story about a magic backpack.")
    // ...
}
VertexAiGeminiApi.kt

Content prompt = new Content.Builder()
        .addText("Write a story about a magic backpack.")
        .build();

ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        // ...
    }

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

Аналогично API для разработчиков Gemini, вы также можете передавать изображения, аудио, видео и файлы вместе с текстовым запросом. Подробнее см. раздел «Взаимодействие с API для разработчиков Gemini из вашего приложения» .

Чтобы узнать больше о Firebase AI Logic SDK, ознакомьтесь с документацией Firebase .