<div data-theme-toc="true"> </div>
# Discourse AI のために Gemini API キーを設定する方法
## はじめに
このトピックでは、既存の Google Cloud アカウントプロジェクトを使用して、Google Gemini API キーを設定する方法について説明します。Gemini は無料サービスではないため、Google Cloud 管理画面で請求先情報が設定されていることを確認する必要があります。
キーの生成ページである [Gemini Developer Studio](https://aistudio.google.com/) には、これに関する重要な情報とリンクがあります。
それでは始めましょう！
> :point_up: **注**: Google Cloud および Discourse フォーラムへの管理者レベルのアクセスが必要です。
***
## ステップ 1: Google Cloud プロジェクトの設定
Gemini API キーを正しく設定するには、Google Cloud アカウントへの管理者アクセス権を持ち、Gemini API キーの使用に利用できる請求先プロジェクトを作成する必要があります。
Gemini Studio でキーを作成して Google Cloud に接続することもできますが、行き来する手間を省くために、Google Cloud コンソールからすべてを処理する方がいくらか簡単です。
組織の [Google Cloud 管理コンソール（API用）](https://console.cloud.google.com/apis/credentials) に移動し、親組織内にいることを確認してください（Google Cloud ロゴの横にある上部のフィールドで確認できます）。
まだ使用したいプロジェクトがない場合は、Gemini キー用にプロジェクトを作成する必要があります（新しいプロジェクトを選択または作成するためのリンクは、ページの左上隅にあります）。
新しいプロジェクトの場合は、新しいプロジェクトの作成ページを完了します（適切なドロップダウンフィールドで組織が選択されていることを確認してください）。
プロジェクトの請求を管理するには、組織で請求が設定されていることを前提として、[Google Cloud 請求先アカウント](https://console.cloud.google.com/billing/projects) でプロジェクトの請求先アカウントを設定する必要があります。キー作成後に、あなた（または請求先アカウント管理者）がこれを行うことができるはずです。組織の Google Cloud アカウントに応じて、プロジェクトと請求プロジェクトにはクォータがあることに注意してください。プロジェクトで請求を有効にするには、Google Cloud ナビゲーションメニューの [請求] タブに移動し、請求先アカウントをリンクし（「請求先アカウントの管理」リンクを参照）、[請求先プロジェクトのページ](https://console.cloud.google.com/billing/projects) からプロジェクトで請求を有効にします。
***
## ステップ 2: Gemini API キーの作成
> :warning: **重要！** API キーは安全に使用することを忘れないでください。[API キーを安全に保つ](https://ai.google.dev/gemini-api/docs/api-key#security) および [API キーを安全に使用するためのベストプラクティス](https://support.google.com/googleapi/answer/6310037) を、続行する前に注意深くお読みください。
これで、プロジェクトで API キーを作成する準備ができました。そのプロジェクトの認証情報に移動し、上部にある「+ 認証情報を作成」リンクをクリックし、ドロップダウンオプションから「API キー」を選択します。
新しい API キーが作成されます。それをコピーして、パスワードボールトアプリケーションのような安全な場所に保管してください。キーを共有しないでください。これは、Discourse AI の設定に入力する必要があるキーです。
キーが API キーの一覧に表示されるはずです。それをクリックして API キーを編集します。
キーに適切な名前を付け、次に「API の制限」セクションまで下にスクロールし、「キーを制限」を選択してから、「Generative Language API」を選択します。
更新されたキーを保存します。「新しいキーを表示」リンクをクリックして新しいキーを表示し、コピーします。
***
## ステップ 3: Discourse AI 設定での Gemini の設定
Discourse AI は現在、API キーを管理するために集中化された **認証情報** システムを使用しています。各 LLM 設定にキーを直接貼り付ける代わりに、まず認証情報を作成し、次に Gemini モデルを設定する際にそれを選択します。
### ステップ 3a: 認証情報の作成
`管理者 > プラグイン > AI > 認証情報` に移動し、**新しい認証情報** をクリックします。わかりやすい名前（例：「Gemini API キー」）を付け、Google Cloud からコピーした API キーを貼り付けます。認証情報を保存します。
> :bulb: **ヒント**: インラインで認証情報を作成することもできます。次のステップで新しい LLM を追加する際に、認証情報セレクタの隣にある **+** ボタンをクリックすると、その場で作成できます。
### ステップ 3b: Gemini LLM の追加
次に、`管理者 > プラグイン > AI > LLM` に移動します。「追加」をクリックし、事前設定された Gemini モデルのいずれか（例：Gemini 3 Flash または Gemini 3 Pro）を選択します。モデル名、エンドポイント URL、その他の設定は自動的に入力されます。前のステップで作成した認証情報を使用するために **認証情報** ドロップダウンを選択し、保存します。
> :information_source: **注**: 同じ認証情報は複数の LLM 設定で再利用できるため、Gemini API キーを入力するのは一度だけで済みます。
***
## ステップ 4: Gemini API キーの使用状況の追跡
Gemini API キーの使用状況は、Google Cloud ダッシュボードの請求セクションの「請求先アカウントの管理」で追跡できます。
次に、請求先プロジェクトリストから特定のプロジェクトを選択すると、API キープロジェクトを追跡するために使用したいプロジェクトやその他の詳細を指定できる請求レポートが表示されます（たとえば、[Google カスタム検索 API とプログラムによるカスタム検索エンジン](https://meta.discourse.org/t/google-search-for-discourse-ai-programmable-search-engine-and-custom-search-api/307107) を設定している場合、Google Cloud アカウントに関連付けられている他の Google API キーもここで追跡できます）。
***
## リンク
* [Google Cloud Console](https://cloud.google.com/cloud-console)
* [Gemini API ドキュメント](https://ai.google.dev/gemini-api/docs/api-key)
* [Discourse AI ドキュメント](https://meta.discourse.org/t/discourse-ai/259214)
* [Discourse AI 向け Google カスタム検索 API](https://meta.discourse.org/t/google-search-for-discourse-ai-programmable-search-engine-and-custom-search-api/307107)
* [API キーを安全に使用するためのベストプラクティス](https://support.google.com/googleapi/answer/6310037)
* [AI ボットを有効にする方法](https://meta.discourse.org/t/enable-ai-bot/266012)
* [Discourse AI 要約を設定する](https://meta.discourse.org/t/discourse-ai-summarization/262711)
* [Google AI の料金](https://ai.google.dev/pricing)
「いいね！」 4