Google Gemini

Gemini 是 Google 最先进的多模态大语言模型,可通过多个 API 访问,包括 Google Vertex AI 和 Google AI Studio(前身为 MakerSuite)。本指南将帮助您在 SillyTavern 中设置 Gemini API 连接。

Google AI Studio

AI Studio 是试用最新 Google AI 模型最快捷、最友好的方式,无需设置 Google Cloud Platform (GCP) 项目。它提供了一个简单的 API 密钥,您可以使用它来访问 Gemini 模型。

步骤 1:创建 Google AI Studio 密钥

  1. 前往 Google AI Studio 页面并使用您的 Google 账户登录。
  2. 点击"获取 API 密钥",接受条款和条件。
  3. 点击"创建 API 密钥"以生成您的 API 密钥。
  4. 将 API 密钥复制到剪贴板。

步骤 2:将 API 密钥输入 SillyTavern

  1. 在 SillyTavern 中,前往"API 连接"页面。
  2. 选择"聊天补全"作为 API 类型。
  3. 从下拉菜单中选择"Google AI Studio"。
  4. 将您之前复制的 API 密钥输入到"API 密钥"文本框中。
  5. 点击"连接"按钮保存密钥。

现在您应该能够在 SillyTavern 中使用 Google AI Studio API 了。

Google Vertex AI

Vertex AI 是 Google Cloud Platform (GCP) 提供的服务。它提供对各种 AI 模型的访问,包括 Gemini 系列。

Vertex AI API 有多种设置方式,可用的模型可能因使用的方法而异。

服务账户

Google Cloud Platform (GCP) 需要服务账户才能访问 Vertex AI,简单的 API 密钥无法使用。将从服务账户 JSON 文件生成令牌,然后用于对 Vertex AI API 的请求进行身份验证。

您可以按照以下步骤创建服务账户:

前提条件:

  1. 您必须拥有 Google Cloud Platform (GCP) 账户。
  2. 您必须在 GCP 账户中创建了项目。
  3. 您必须为该项目启用了计费。

步骤 1:启用 Vertex AI API

在密钥可以工作之前,必须为您的项目启用 API。

  1. 前往 Google Cloud 控制台:https://console.cloud.google.com/
  2. 确保在顶部栏中选择了正确的项目。
  3. 导航到 Vertex AI API 页面:https://console.cloud.google.com/apis/library/aiplatform.googleapis.com
  4. 如果尚未启用,请点击"启用"按钮。

步骤 2:创建服务账户

这是将用于访问 Vertex AI API 的身份。

  1. 在 Google Cloud 控制台中,导航到"服务账户"页面。您可以在顶部搜索栏中搜索它,或使用此直接链接:https://console.cloud.google.com/iam-admin/serviceaccounts
  2. 选择您的 GCP 项目,然后点击"+ 创建服务账户"。
  3. 服务账户名称:给它一个描述性的名称,例如 my-vertex-ai-client
  4. 点击"创建并继续"。
  5. 授予此服务账户对项目的访问权限:在"角色"下拉菜单中,搜索并选择 Vertex AI 用户。此角色授予运行模型所需的必要权限,而不会授予过多的访问权限。
  6. 点击"继续",然后点击"完成"。

步骤 3:生成 JSON 密钥

这是您需要的"密码"文件。它包含敏感信息,因此不要分享或上传到任何公共位置。

  1. 您现在应该回到服务账户列表。找到您刚刚创建的账户(例如,sillytavern-vertex-ai)。
  2. 点击该行最右侧的三点菜单 (⋮),然后选择"管理密钥"。
  3. 点击"添加密钥" -> "创建新密钥"。
  4. 确保密钥类型设置为 JSON。
  5. 点击"创建"。

一个 .json 文件将立即下载到您的计算机。请妥善保管,因为如果丢失,此密钥无法恢复。

步骤 4:将 JSON 内容输入 SillyTavern

您下载的 JSON 文件包含与 Vertex AI API 进行身份验证所需的所有信息。它看起来像这样:

{
    "type": "service_account",
    "project_id": "your-gcp-project-name",
    "private_key_id": "...",
    "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
    "client_email": "sillytavern-vertex-ai@your-gcp-project-name.iam.gserviceaccount.com",
    "client_id": "...",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_x509_cert_url": "..."
}
  1. 使用简单的文本编辑器(如 Windows 上的记事本、Mac 上的 TextEdit 或 VS Code)打开您刚下载的 .json 文件。
  2. 选择文件中的所有文本(Ctrl+A 或 Cmd+A)。
  3. 将文本复制到剪贴板(Ctrl+C 或 Cmd+C)。
  4. 在 SillyTavern 中,前往"API 连接"页面,选择"聊天补全"作为 API 类型,然后从下拉菜单中选择"Google Vertex AI"。将身份验证方法切换为"服务账户"。
  5. 将整个复制的内容粘贴到"服务账户 JSON 内容"文本框中。
  6. 点击"验证 JSON"按钮以确保您正确复制了它。
  7. 最后,向下滚动并点击 API 设置页面底部的"连接"。

现在您应该能够在 SillyTavern 中使用 Google Vertex AI API 了。

快速模式

快速模式是开始在 Google Cloud 上使用生成式 AI 的最快方式。它允许您使用 Gemini API,而无需设置服务账户。相反,您可以直接使用 API 密钥。

有关更多详细信息,请参阅官方文档:快速模式下的 Vertex AI 概述

步骤 1:确保您的账户符合快速模式的资格

您必须拥有之前未用于创建 Google Cloud 项目的 Google 账户。 如果您有现有的 Google Cloud 项目(包括免费试用),可以为此目的创建一个新项目。

步骤 2:激活 Vertex AI 快速模式

  1. 前往以下网页:Vertex AI Studio
  2. 点击"免费试用"。
  3. 接受条款和条件,并使用您的 Google 账户登录。
  4. 选择您的国家/地区,然后点击"同意并免费开始"。等待设置完成。

步骤 3:创建 API 密钥

  1. 验证您的 Google Cloud 控制台是否以快速模式运行。您应该在页面左上角看到一个横幅。
  2. 点击左侧边栏中的"API 密钥"链接。
  3. 点击"创建 API 密钥"按钮。
  4. 将生成一个新的 API 密钥。将此密钥复制到剪贴板。

步骤 4:将 API 密钥输入 SillyTavern

  1. 在 SillyTavern 中,前往"API 连接"页面。
  2. 选择"聊天补全"作为 API 类型。
  3. 从下拉菜单中选择"Google Vertex AI"。
  4. 将身份验证方法切换为"快速模式(API 密钥)"。
  5. 将您之前复制的 API 密钥粘贴到"API 密钥"文本框中。
  6. 点击"连接"按钮保存密钥。

现在您应该能够在 SillyTavern 中以快速模式使用 Google Vertex AI API 了。