如何为 Discourse AI 设置 Gemini API 密钥
简介
本主题介绍如何将您的 Google Gemini API 密钥与现有的 Google Cloud 账户项目关联起来。Gemini 不是免费服务，因此您需要确保在 Google Cloud 管理中配置了结算。
在生成密钥的 Gemini 开发者工作室 页面上有关于此的一些重要信息，其中包含链接：
好的，让我们开始吧！
注意：需要 Google Cloud 和您的 Discourse 论坛的管理员级别访问权限。
步骤 1：设置 Google Cloud 项目
正确设置 Gemini API 密钥需要您拥有对 Google Cloud 账户的管理员访问权限，并在此处创建一个可用于 Gemini API 密钥使用的结算项目。
您可以在 Gemini Studio 中创建密钥并连接到您的 Google Cloud，但从 Google Cloud 控制台进行所有操作会稍微简单一些，这样您就无需来回切换。
前往您组织用于 API 的 Google Cloud 管理界面，并确保您位于父组织中（您可以在 Google Cloud 徽标旁边的顶部字段中看到）。
如果您还没有要使用的项目，您将需要为您的 Gemini 密钥创建一个项目（请注意，选择或创建新项目的链接位于页面左上方）。
对于新项目，填写创建新项目页面（确保在适当的下拉字段中选择了您的组织）。
要管理项目的结算，您需要为您在该项目设置一个结算账户，请访问 Google Cloud 结算，前提是您的组织已配置了结算。您（或您的结算管理员）应能在密钥创建后稍后执行此操作。请注意，根据您组织的 Google Cloud 账户，项目和结算项目都有配额。要为您的项目启用结算，请转到 Google Cloud 导航菜单中的“结算”标签页，链接一个结算账户（参见“管理结算账户”链接），并从 结算项目页面 为该项目启用结算。
步骤 2：创建 Gemini API 密钥
重要提示！ 请记住安全使用您的 API 密钥。在继续之前，请仔细阅读 保持您的 API 密钥安全 和 安全使用 API 密钥的最佳实践。
现在您可以开始在项目中创建 API 密钥了。转到该项目的凭据，点击顶部的“+ 创建凭据”链接，然后从下拉选项中选择“API 密钥”。
系统将为您创建一个新的 API 密钥。复制它并将其安全地保存在安全的位置，例如密码保险库应用程序中。请勿共享密钥。这是您需要输入到 Discourse AI 设置中的密钥。
该密钥现在应列在您的 API 密钥中。单击它以编辑 API 密钥。
为密钥命名一个合适的名称，然后向下滚动到“API 限制”部分并选择“限制密钥”，然后选择“生成式语言 API”。
保存您的更新后的密钥。点击新密钥的“显示密钥”链接并复制它。
步骤 3：在 Discourse AI 设置中配置 Gemini
Discourse AI 现在使用集中式的凭据系统来管理 API 密钥。您不再需要将密钥直接粘贴到每个 LLM 配置中，而是首先创建一个凭据，然后在配置 Gemini 模型时选择它。
步骤 3a：创建凭据
转到 Admin (管理员) > Plugins (插件) > AI > Credentials (凭据)，然后单击 New Credential (新建凭据)。为其指定一个描述性名称（例如“Gemini API 密钥”），然后粘贴您从 Google Cloud 复制的 API 密钥。保存凭据。
提示：您也可以在添加新 LLM（下一步）时，点击凭据选择器旁边的 + 按钮，在线创建凭据，即时创建。
步骤 3b：添加 Gemini LLM
现在转到 Admin (管理员) > Plugins (插件) > AI > LLMs。点击 Add (添加) 并选择一个预配置的 Gemini 模型（例如 Gemini 3 Flash 或 Gemini 3 Pro）。模型名称、端点 URL 和其他设置将为您预先填充。使用 Credential (凭据) 下拉菜单选择您在上一步中创建的凭据，然后保存。
注意：同一个凭据可以跨多个 LLM 配置重复使用，因此您只需输入 Gemini API 密钥一次即可。
步骤 4：跟踪 Gemini API 密钥使用情况
您可以从 Google Cloud 仪表板的“管理结算账户”下的结算部分跟踪您的 Gemini API 密钥使用情况。
然后选择您的特定项目，它将显示结算报告，您可以在其中指定要用于跟踪 API 密钥项目的项目和其他各种详细信息（例如，如果您配置了 Google 自定义搜索 API 和可编程搜索引擎，您也可以在此处跟踪附加到您的 Google Cloud 账户的其他 Google API 密钥）。
