GCH空城

Gemini API 中转

使用指南：基于 Gemini Balance Lite 的 API 中转服务配置教程

本文旨在指导用户如何配置和使用搭建于 https://api.gchkc.de5.net 的 Gemini API 中转服务。该服务基于开源项目 gemini-balance-lite 构建，通过 Cloudflare Workers 实现 API 的负载均衡与转发，旨在为用户提供更加稳定、流畅的 Google Gemini 模型调用体验。本教程将详细演示如何在 Chatbox 和 Cherry Studio 等主流客户端中完成配置。

🛠️ 服务参数概览

在开始配置客户端之前，请确保您已知晓以下基础参数。无论使用何种客户端，这些都是核心配置项：

  • API 服务地址 (Base URL/Host)（个人自建）:
https://api.gchkc.de5.net
  • API Key (凭证): 请使用您申请的 Google Gemini API Key（或管理员分发的专用 Key）。如果还没有 API Key，请参考下方的获取教程。
  • 支持模型: 支持 Google Gemini 系列主流模型（如 gemini-2.5-flash, gemini-3.0-flash, gemini-3.0-pro 等）。

🔑 如何获取 Google Gemini API Key

在使用中转服务之前，您需要先获取 Google Gemini 的 API Key。以下是详细的获取步骤：

方法一：从 Google AI Studio 获取（推荐）

  1. 访问 Google AI Studio
    打开浏览器，访问 https://aistudio.google.com/

  2. 登录 Google 账号
    使用您的 Google 账号登录（如果没有账号，需要先注册一个）

  3. 获取 API Key

    • 登录后，在页面左侧菜单栏找到 "Get API key" 或 "API keys" 选项
    • 点击进入 API Key 管理页面
    • 点击 "Create API key" 按钮

  4. 选择或创建项目

    • 如果您已有 Google Cloud 项目，可以直接选择一个现有项目
    • 如果是第一次使用，点击 "Create API key in new project"（在新项目中创建 API Key）
    • 系统会自动创建一个新的 Google Cloud 项目并生成 API Key

获取API Key示例

  1. 复制 API Key

    • API Key 生成后会显示在页面上，格式类似：AIzaSyXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxX
    • 点击复制按钮，将 API Key 保存到安全的地方
    • ⚠️ 重要提示： 请妥善保管您的 API Key，不要将其分享给他人或上传到公开的代码仓库中

  2. 验证 API Key（可选）

    • 在 AI Studio 界面中，您可以直接测试 API Key 是否可用
    • 选择一个模型（如 Gemini 2.5 Flash）进行简单的对话测试

注意事项

  • 免费额度： Google Gemini API 提供一定的免费使用额度，日常足够使用，具体限制请查看 官方定价页面
  • 地区限制： 部分地区可能无法直接访问 Google AI Studio，您可能需要使用代理或 VPN
  • API 配额： 每个 API Key 都有请求频率限制，请合理使用
  • 多个 Key： 如果需要更高的配额，可以创建多个项目并生成多个 API Key

常见获取问题

Q: 无法访问 Google AI Studio 怎么办？
A: 请确保您的网络可以访问 Google 服务。如果无法访问，可能需要使用代理服务。

Q: API Key 生成后无法使用？
A: 新创建的 API Key 可能需要几分钟才能生效，请稍等片刻后再试。同时请确认您的 Google Cloud 项目已启用 Gemini API。

📱 客户端配置指南

1. Chatbox 配置教程

Chatbox 是一款支持多平台的优秀 AI 客户端。请按照以下步骤配置：

  1. 打开 Chatbox，点击左下角的 设置 (Settings) ⚙️ 图标。
  2. 在 模型提供方 (Model Provider) 列表中，选择 Google Gemini。
  3. 填写配置信息：
  • API Key: 填入您的 API 密钥。
  • API 域名 (API Host): 将默认地址修改为： https://api.gchkc.de5.net
  1. 选择模型: 在模型下拉菜单中选择您想使用的模型（例如 gemini-2.5-flash）。
  2. 点击 保存，即可开始对话。

注意： 务必确保 API 域名中不包含 /v1 或其他后缀，仅保留基础域名即可，除非客户端有特殊说明。

2. Cherry Studio 配置教程

Cherry Studio 是一款面向专业用户的强大 AI 工作台。配置步骤如下：

  1. 启动 Cherry Studio，点击左侧边栏的 设置 图标。
  2. 进入 模型服务 (Model Provider) 页面，找到并点击 Google 提供商。
  3. 配置连接参数：
  • API 密钥 (API Key): 输入您的密钥。
  • API 域名 (API Domain): 点击编辑或输入框，将其修改为： https://api.gchkc.de5.net
  1. 点击下方的 管理模型 (Manage Models)，添加或启用您需要的 Gemini 模型（如 gemini-2.5-flash）。
  2. 点击 检查连接 (Check) 按钮，显示连接成功后即可使用。

❓ 常见问题 (FAQ)

Q: 为什么要使用这个中转服务？ A: 该服务参考了 gemini-balance-lite 项目，通过边缘节点转发请求，可以有效解决部分网络环境下直接访问 Google API 不稳定或无法连接的问题，同时具备一定的负载调节能力。

Q: 连接测试失败怎么办？ A:

  1. 请检查 API Key 是否有效。
  2. 请确认 Base URL 填写正确，不要多复制空格或斜杠。
  3. 检查您的网络连接是否正常。

Q: 数据安全吗？ A: 本服务仅作为 API 流量的中转管道，基于开源代码构建，旨在优化连接体验。虽然我们不保存用户聊天记录，但建议不要在使用中转服务时发送涉及个人隐私、金融账户等高度敏感的信息。

致谢： 本服务核心逻辑源自 GitHub 开源项目 gemini-balance-lite，感谢原作者的贡献。

← 返回首页