Firebase AI Logic の基本

概要

Firebase AI Logic は Firebase の製品で、クライアント側の SDK を使用してモバイルアプリと Web アプリに生成 AI を追加できます。専用のバックエンドを管理することなく、アプリから直接 Gemini モデルを呼び出すことができます。Firebase AI Logic は、以前「Vertex AI for Firebase」として知られていた製品で、モバイルおよび Web 開発者向けの Google の AI 統合プラットフォームの進化形です。

2 つの Gemini API プロバイダーをサポートしています:

• Gemini Developer API: プロトタイピングに最適な無料ティアがあり、本番環境ではペイアズユーゴー課金
• Vertex AI Gemini API: スケールに対応した企業レベルの本番対応が必要で、Blaze プランが必要

デフォルトとして Gemini Developer API を使用し、アプリケーションが必要な場合のみ Vertex AI Gemini API を使用してください。

セットアップと初期化

前提条件

• 開始する前に、Node.js 16 以上と npm がインストールされていることを確認してください。まだインストールされていない場合はインストールしてください。
• ユーザーが構築したいプラットフォーム (Android、iOS、Flutter、Web) を事前に特定してください。
• プラットフォームがサポートされていない場合、Firebase Docs にユーザーを案内して、アプリケーション用の AI Logic セットアップ方法を学習させてください（このリンクをユーザーと共有してください: https://firebase.google.com/docs/ai-logic/get-started）

インストール

ライブラリは標準の Firebase Web SDK の一部です。

npm install -g firebase@latest

firebase ディレクトリ (firebase.json を含む) に入っている場合は、現在選択されているプロジェクトがこのコマンドで「current」とマークされます:

npx -y firebase-tools@latest projects:list

現在のプロジェクトに少なくとも 1 つのアプリが関連付けられていることを確認してください

npx -y firebase-tools@latest apps:list

init コマンドで AI Logic SDK を初期化します

npx -y firebase-tools@latest init ailogic

これにより、Firebase コンソールで Gemini Developer API が自動的に有効になります。

詳細は Firebase AI Logic Getting Started を参照してください

コア機能

テキスト専用生成

マルチモーダル (テキスト + 画像/音声/ビデオ/PDF 入力)

Firebase AI Logic により、Gemini モデルはアプリから直接画像ファイルを分析できます。これにより、キャプション作成、画像に関する質問への回答、オブジェクト検出、画像分類などの機能が実現します。画像以外にも、Gemini は音声、ビデオ、PDF などの他のメディアタイプを、MIME タイプと共にインラインデータとして渡すことで分析できます。20 メガバイトを超えるファイル (インラインデータとして HTTP 413 エラーが発生する可能性がある) の場合は、Cloud Storage for Firebase に保存し、その URL を Gemini Developer API に渡してください。

チャットセッション (マルチターン)

startChat を使用して履歴を自動的に保持します。

ストリーミング応答

部分的な結果が到着するときに表示する (タイピング効果のような) ことでユーザーエクスペリエンスを向上させるには、結果の高速表示のために generateContent の代わりに generateContentStream を使用してください。

Nano Banana を使用した画像生成

• ほとんどのユースケースでは Gemini で始め、画像品質と特定のスタイルが重要な専門的なタスクでは Imagen を選択してください。(例: gemini-2.5-flash-image)
• アップグレードされた Blaze ペイアズユーゴー課金プランが必要です。

組み込み googleSearch ツールを使用した検索グラウンディング

サポートされるプラットフォームとフレームワーク

サポートされるプラットフォームとフレームワークには、Android 向けの Kotlin と Java、iOS 向けの Swift、Web アプリ向けの JavaScript、Flutter 向けの Dart、Unity 向けの C Sharp が含まれます。

高度な機能

構造化出力 (JSON)

応答の特定の JSON スキーマを強制します。

オンデバイス AI (ハイブリッド)

Web アプリ向けのハイブリッドオンデバイス推論。Firebase Javascript SDK はインストール後に Gemini Nano の可用性を自動的にチェックし、オンデバイス実行とクラウドホスト型プロンプト実行を切り替えます。これには Chrome ブラウザでのモデル使用を有効にするための特定の手順が必要です。詳細は ハイブリッドオンデバイス推論ドキュメント を参照してください。

セキュリティと本番環境

App Check

[!WARNING] 重大なセキュリティ要件: AI Logic を安全に使用するには、アプリで App Check を設定する必須です。これにより、許可されていないクライアントが API クォータを使用したり、バックエンドリソースにアクセスしたりするのを防ぎます。

セットアップ手順については reCAPTCHA Enterprise を使用した App Check を参照してください。

Remote Config

モデル名 (例: gemini-flash-lite-latest) をハードコーディングする必要がないことに注意してください。Firebase Remote Config を使用して、新しいクライアントコードをデプロイすることなく、モデルバージョンを動的に更新してください。モデル名をリモートで変更する を参照してください。

[!WARNING] 重大: バックエンドプロビジョニング必須 すべてのプラットフォーム (Flutter、Android、iOS、Web) に対して、npx firebase-tools init ailogic を実行してサービスをプロビジョニングする必須です。flutterfire configure はクライアント設定のみを処理し、AI サービスを有効にしないため、PERMISSION_DENIED エラーが発生します。

初期化コードリファレンス

言語、フレームワーク、プラットフォーム	Gemini API プロバイダー	コンテキスト URL
Web Modular API	Gemini Developer API	firebase://docs/ai-logic/get-started
iOS (Swift)	Gemini Developer API	ios_setup.md
Flutter (Dart)	Gemini Developer API	flutter_setup.md

別の Gemini バージョンがドキュメントまたはユーザーによってリクエストされない限り、常に最新の Gemini バージョン (gemini-flash-latest) を使用してください。gemini-1.5-flash を使用しないでください。

リファレンス

Web SDK コード例と使用パターン iOS SDK コード例と使用パターン Flutter SDK コード例と使用パターン

Android (Kotlin) SDK 使用パターン