Powered by

Google Gemini

Gemini 是 Google 的前沿多模态大语言模型，可通过多个 API 访问，包括 Google Vertex AI 和 Google AI Studio（前身为 MakerSuite）。本指南将帮助你在 SillyTavern 中设置 Gemini API 连接。

Google AI Studio

AI Studio 是试用最新 Google AI 模型最快捷、最友好的方式，无需创建 Google 云平台（GCP）项目。它提供一个简单的 API 密钥，你可以用它来访问 Gemini 模型。

步骤 1：创建 Google AI Studio 密钥

  1. 前往 Google AI Studio 页面，并使用你的 Google 账号登录。
  2. 点击“Get API Key”，接受相关条款和条件。
  3. 点击“Create API Key”生成你的 API 密钥。
  4. 将 API 密钥复制到剪贴板。

步骤 2：将 API 密钥填入 SillyTavern

  1. 在 SillyTavern 中，前往“API 连接”页面。
  2. 选择“Chat Completion”作为 API 类型。
  3. 从下拉菜单中选择“Google AI Studio”。
  4. 将你刚才复制的 API 密钥粘贴到“API Key”文本框中。
  5. 点击“Connect”按钮以保存密钥。

你现在应该可以在 SillyTavern 中使用 Google AI Studio API 了。

Google Vertex AI

Vertex AI 是 Google 云平台（GCP）提供的一项服务，可访问多种 AI 模型，包括 Gemini 系列。

Vertex AI API 有多种设置方式，可用的模型可能因所选方式而异。

服务账号

Google 云平台（GCP）需要使用服务账号来访问 Vertex AI，普通 API 密钥无法使用。系统会根据服务账号的 JSON 文件生成一个令牌，用于对 Vertex AI API 的请求进行身份验证。

你可以按照以下步骤创建服务账号：

前提条件：

  1. 你必须拥有一个 Google 云平台（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. 如果该 API 尚未启用，请点击“Enable”按钮。

步骤 2：创建服务账号

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

  1. 在 Google Cloud 控制台中，前往“Service Accounts”页面。你可以在顶部搜索栏中搜索它，或使用此直达链接：https://console.cloud.google.com/iam-admin/serviceaccounts
  2. 选择你的 GCP 项目，然后点击“+ CREATE SERVICE ACCOUNT”。
  3. 服务账号名称：给它一个有描述性的名称，例如 my-vertex-ai-client。
  4. 点击“CREATE AND CONTINUE”。
  5. 向该服务账号授予项目访问权限：在“Role”下拉菜单中，搜索并选择 Vertex AI User。此角色授予运行模型所需的权限，同时不会赋予过多访问权限。
  6. 点击“CONTINUE”，然后点击“DONE”。

步骤 3：生成 JSON 密钥

这是你需要的“密码”文件。其中包含敏感信息，请勿分享或上传到任何公开位置。

  1. 你现在应该回到了服务账号列表。找到你刚创建的账号（例如 sillytavern-vertex-ai）。
  2. 点击该行最右侧的三点菜单（⋮），然后选择“Manage keys”。
  3. 点击“ADD KEY”->“Create new key”。
  4. 确保密钥类型设置为 JSON。
  5. 点击“CREATE”。

一个 .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 上的文本编辑，或 VS Code）打开你刚下载的 .json 文件。
  2. 选中文件中的全部文本（Ctrl+A 或 Cmd+A）。
  3. 将文本复制到剪贴板（Ctrl+C 或 Cmd+C）。
  4. 在 SillyTavern 中，前往“API 连接”页面，选择“Chat Completion”作为 API 类型，然后从下拉菜单中选择“Google Vertex AI”。将身份验证方式切换为“Service Account”。
  5. 将刚才复制的全部内容粘贴到“Service Account JSON Content”文本框中。
  6. 点击“Validate JSON”按钮，确认你复制的内容无误。
  7. 最后，向下滚动并点击 API 设置页面底部的“Connect”。

你现在应该可以在 SillyTavern 中使用 Google Vertex AI API 了。

Express 模式

Express 模式是在 Google Cloud 上开始使用生成式 AI 最快捷的方式。它允许你直接使用 API 密钥访问 Gemini API，无需创建服务账号。

更多详情，请参阅官方文档：Vertex AI in express mode overview。

步骤 1：确认你的账号符合 Express 模式条件

你必须拥有一个此前未用于创建 Google Cloud 项目的 Google 账号。 如果你已有现成的 Google Cloud 项目（包括免费试用），可以为此目的新建一个。

步骤 2：激活 Vertex AI Express 模式

  1. 前往以下网页：Vertex AI Studio。
  2. 点击“Try it free”。
  3. 接受相关条款和条件，并使用你的 Google 账号登录。
  4. 选择你的国家/地区，然后点击“Agree & start free”。等待设置完成。

步骤 3：创建 API 密钥

  1. 确认你的 Google Cloud 控制台正以 Express 模式运行。你应该能在页面左上角看到一条横幅。
  2. 点击左侧边栏中的“API Keys”链接。
  3. 点击“Create API Key”按钮。
  4. 系统会生成一个新的 API 密钥。将此密钥复制到剪贴板。

步骤 4：将 API 密钥填入 SillyTavern

  1. 在 SillyTavern 中，前往“API 连接”页面。
  2. 选择“Chat Completion”作为 API 类型。
  3. 从下拉菜单中选择“Google Vertex AI”。
  4. 将身份验证方式切换为“Express Mode (API Key)”。
  5. 将你刚才复制的 API 密钥粘贴到“API Key”文本框中。
  6. 点击“Connect”按钮以保存密钥。

你现在应该可以在 SillyTavern 中以 Express 模式使用 Google Vertex AI API 了。

© Copyright 2026. All rights reserved.