Firebase AI Logic SDK を使用して Gemini API を使ってみる

このガイドでは、選択したプラットフォーム用の Firebase AI Logic クライアント SDK を使用して、アプリから Gemini API への呼び出しを直接開始する方法について説明します。

前提条件

Swift

このガイドは、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 ゲームが次の要件を満たしていることを確認します。

  • Unity Editor 2021 LTS 以降

役立つリソースを確認する

Swift

クイックスタート アプリを試す

クイックスタート アプリを使用して、SDK をすばやく試し、さまざまなユースケースの完全な実装を確認してください。独自の Apple プラットフォーム アプリがない場合は、クイックスタート アプリを使用します。クイックスタート アプリを使用するには、Firebase プロジェクトに接続する必要があります。

クイックスタート アプリに移動する

動画チュートリアルを視聴する

この動画では、テキスト プロンプトからレシピを生成する実際の AI 搭載の食事プランニング アプリを構築して、Firebase AI Logic の使用を開始する方法を紹介します。

動画で紹介しているアプリのコードベースをダウンロードして確認することもできます。

動画のアプリのコードベースを表示する



Kotlin

クイックスタート アプリを試す

クイックスタート アプリを使用して、SDK をすばやく試し、さまざまなユースケースの完全な実装を確認してください。独自の Android アプリがない場合は、クイックスタート アプリを使用します。クイックスタート アプリを使用するには、Firebase プロジェクトに接続する必要があります。

クイックスタート アプリに移動する

動画チュートリアルを視聴する

この動画では、テキスト プロンプトからレシピを生成する実際の AI 搭載の食事プランニング アプリを構築して、Firebase AI Logic の使用を開始する方法を紹介します。

動画で紹介しているアプリのコードベースをダウンロードして確認することもできます。

動画のアプリのコードベースを表示する



Java

クイックスタート アプリを試す

クイックスタート アプリを使用して、SDK をすばやく試し、さまざまなユースケースの完全な実装を確認してください。独自の Android アプリがない場合は、クイックスタート アプリを使用します。クイックスタート アプリを使用するには、Firebase プロジェクトに接続する必要があります。

クイックスタート アプリに移動する

動画チュートリアルを視聴する

この動画では、テキスト プロンプトからレシピを生成する AI 搭載の食事プランニング アプリを実際に作成して、Firebase AI Logic の使用を開始する方法について説明します。*

動画で紹介しているアプリのコードベースをダウンロードして確認することもできます。

動画のアプリのコードベースを表示する

* この動画とそのアプリは Kotlin で作成されていますが、Java デベロッパーが Firebase AI Logic を始めるための基本を理解するうえで役立ちます。

Web

クイックスタート アプリを試す

クイックスタート アプリを使用して、SDK をすばやく試し、さまざまなユースケースの完全な実装を確認してください。独自のウェブアプリがない場合は、クイックスタート アプリを使用します。クイックスタート アプリを使用するには、Firebase プロジェクトに接続する必要があります。

クイックスタート アプリに移動する

Dart

クイックスタート アプリを試す

クイックスタート アプリを使用して、SDK をすばやく試し、さまざまなユースケースの完全な実装を確認してください。独自の Flutter アプリがない場合は、クイックスタート アプリを使用します。クイックスタート アプリを使用するには、Firebase プロジェクトに接続する必要があります。

クイックスタート アプリに移動する

動画チュートリアルを視聴する

この動画では、テキスト プロンプトからレシピを生成する実際の AI 搭載の食事プランニング アプリを構築して、Firebase AI Logic の使用を開始する方法を紹介します。

動画で紹介しているアプリのコードベースをダウンロードして確認することもできます。

動画のアプリのコードベースを表示する



Unity

クイックスタート アプリを試す

クイックスタート アプリを使用して、SDK をすばやく試し、さまざまなユースケースの完全な実装を確認してください。独自の Unity ゲームがない場合は、クイックスタート アプリを使用します。クイック スタート アプリを使用するには、Firebase プロジェクトに接続する必要があります。

クイックスタート アプリに移動する

ステップ 1: Firebase プロジェクトを設定して API を有効にする

  1. Firebase コンソールにログインし、Firebase プロジェクトを選択します。

  2. Firebase コンソールで、[AI サービス] > [AI ロジック] に移動します。

  3. [使ってみる] をクリックして、プロジェクトに必要な API とリソースの設定に役立つガイド付きワークフローを起動します。

  4. メッセージが表示されたら、画面上の手順に沿ってアプリを登録し、Firebase 構成をアプリに追加します。

  5. [Gemini API プロバイダ] を選択するよう求められたら、Gemini Developer API を選択することをおすすめします。これにより、無料で迅速に始めることができます。

    後からいつでも Vertex AI Gemini API を設定できます(お支払いに関する要件も同様です)。

  6. ワークフローを続行して、Firebase AI Logic に必要な API と関連サービスを設定します。

    2026 年 7 月上旬より、ワークフローのこのステージでは、アプリから直接アクセスされたときに Gemini API を保護するのに役立つ重要なサービスである AI Logic に対して Firebase App Check が自動的に適用されます。スタートガイド(このガイドの後半のステップを参照)の一環として、App Check が適用されるときにローカル開発用の App Check デバッグ プロバイダを構成する必要があります。

  7. このガイドの次の手順に進み、必要な SDK をアプリに追加します。

ステップ 2: 必要な SDK を追加する

Firebase プロジェクトが設定され、必要な API が有効になったら(前の手順を参照)、必要な SDK をアプリに追加できます。

Swift

Swift Package Manager を使用して Firebase の依存関係のインストールと管理を行います。必要に応じて、その他のインストール オプションについて確認します。

Firebase AI Logic ライブラリは、Gemini モデルを操作するための API へのアクセスを提供します。このライブラリは、Apple プラットフォーム用の Firebase SDK(firebase-ios-sdk)の一部として含まれています。

Firebase をすでに使用している場合は、Firebase パッケージが v12.5.0 以降であることを確認してください。

  1. Xcode でアプリ プロジェクトを開いたまま、[File] > [Add Package Dependencies] の順に移動します。

  2. プロンプトが表示されたら、Firebase Apple プラットフォーム SDK リポジトリを追加します。

    https://github.com/firebase/firebase-ios-sdk
    
  3. 最新の SDK バージョンを選択します。

  4. FirebaseAILogic ライブラリと FirebaseAppCheck ライブラリを選択します。

上記の作業が完了すると、Xcode は依存関係の解決とバックグラウンドでのダウンロードを自動的に開始します。

Kotlin

Android 用 Firebase AI Logic SDK(firebase-ai)は、Gemini モデルを操作するための API へのアクセスを提供します。

モジュール(アプリレベル)の Gradle ファイル<project>/<app-module>/build.gradle.kts など)に、Android 用 Firebase AI Logic ライブラリと App Check ライブラリの依存関係を追加します。ライブラリのバージョニングの制御には、Firebase Android BoM を使用することをおすすめします。

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.16.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 ライブラリを使用します。