Gemini Balance Lite

Gemini API 代理和负载均衡无服务器轻量版（边缘函数）

作者：技术爬爬虾

B站，Youtube，抖音，公众号 全网同名。转载请注明作者。

项目简介

Gemini API 代理, 使用边缘函数把Gemini API免费中转到国内。还可以聚合多个Gemini API Key，随机选取API Key的使用实现负载均衡，使得Gemini API免费成倍增加。

Vercel部署(推荐)

1. 点击部署按钮⬆️一键部署。
2. 国内使用需要配置自定义域名
   配置自定义域名：

   
3. 去AIStudio申请一个免费Gemini API Key

将API Key与自定义的域名填入AI客户端即可使用，如果有多个API Key用逗号分隔

![image](https://oss.gittoolsai.com/images/tech-shrimp_gemini-balance-lite_readme_c6d2f432df3d.png)
</details>

curl -X POST --location 'https://<YOUR_DEPLOYED_DOMAIN>/v1beta/models/gemini-2.5-pro:generateContent' \
--header 'Content-Type: application/json' \
--header 'x-goog-api-key: <YOUR_GEMINI_API_KEY_1>,<YOUR_GEMINI_API_KEY_2>' \
--data '{
    "contents": [
        {
         "role": "user",
         "parts": [
            {
               "text": "Hello"
            }
         ]
      }
    ]
}'

curl -X POST --location 'https://<YOUR_DEPLOYED_DOMAIN>/v1beta/models/gemini-2.5-pro:generateContent?alt=sse' \
--header 'Content-Type: application/json' \
--header 'x-goog-api-key: <YOUR_GEMINI_API_KEY_1>,<YOUR_GEMINI_API_KEY_2>' \
--data '{
    "contents": [
        {
         "role": "user",
         "parts": [
            {
               "text": "Hello"
            }
         ]
      }
    ]
}'

curl -X POST --location 'https://<YOUR_DEPLOYED_DOMAIN>/verify' \
--header 'x-goog-api-key: <YOUR_GEMINI_API_KEY_1>,<YOUR_GEMINI_API_KEY_2>'

curl -X POST --location 'https://<YOUR_DEPLOYED_DOMAIN>/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_GEMINI_API_KEY>' \
--data '{
    "model": "gpt-3.5-turbo",
    "messages": [
        {
            "role": "user",
            "content": "你好"
        }
    ]
}'

Gemini Balance Lite 快速上手指南

Gemini Balance Lite 是一款基于边缘函数的轻量级 Gemini API 代理与负载均衡工具。它支持将多个 Gemini API Key 聚合，通过随机轮询实现负载均衡，有效突破单 Key 限制，并提供国内可访问的自定义域名中转服务。

环境准备

本项目主要依赖云端无服务器平台部署，本地调试需以下环境：

• 操作系统：Windows / macOS / Linux
• 前置依赖：
  • Node.js (用于本地调试)
  • Git (用于克隆代码)
  • 任意主流 AI 客户端（如 Cherry Studio）或 HTTP 请求工具（如 Curl）
• 必备资源：
  • Google AI Studio 申请的免费 Gemini API Key（支持多个，用逗号分隔）
  • 推荐准备一个自定义域名（若使用 Vercel/Cloudflare 且在国内访问）

安装步骤

推荐使用 Vercel 进行一键部署，流程最简单且稳定。

方案一：Vercel 部署（推荐）

1. 点击下方按钮一键克隆并部署：

2. 配置自定义域名（国内访问必需）：

   • 在 Vercel 项目设置中绑定您的自定义域名，以确保国内网络畅通。

3. 获取 API Key：

   • 前往 AI Studio 申请 Key。
   • 若有多个 Key，请在后续配置中使用英文逗号 , 分隔。

方案二：Cloudflare Worker 部署

⚠️ 注意：CF Worker 可能分配香港节点导致无法连接 Gemini（Gemini 屏蔽香港 IP），广东地区用户不建议使用此方案。

1. 点击部署按钮：

2. 登录 Cloudflare 账号并关联 GitHub 完成部署。

3. 在 Cloudflare 后台为 Worker 绑定自定义域名（国内访问必需）。

方案三：Deno Deploy 部署

1. Fork 本项目到您的 GitHub 账户。
2. 登录 Deno Dashboard 创建新项目 (New Project)。
3. 选择您的仓库，填写项目名称（影响自动分配的域名）。
4. Entrypoint 字段填写：src/deno_index.ts，其余留空。
5. 点击 Deploy Project，部署成功后获取域名并配置自定义域名（如需国内访问）。

本地调试

如需在本地开发测试，请执行以下命令：

# 1. 安装 Vercel CLI
npm install -g vercel

# 2. 进入项目根目录
cd gemini-balance-lite

# 3. 启动本地开发服务
vercel dev

基本使用

部署完成后，您将获得一个专属域名（例如 https://your-domain.vercel.app）。

1. 配置 AI 客户端

以 Cherry Studio 或其他支持自定义 API 的客户端为例：

• API 地址 (Base URL)：填入您的部署域名（如 https://your-domain.vercel.app）。
• API Key：填入您的 Gemini API Key。
  • 支持负载均衡：若有多个 Key，格式为 Key1,Key2,Key3。
• 模型名称：根据需求填写（如 gemini-pro 或兼容 OpenAI 格式时的 gpt-3.5-turbo）。

2. API 调用示例

本项目原生支持 Gemini API 格式，同时兼容 OpenAI 格式。

方式 A：原生 Gemini 格式 (Curl)

curl -X POST --location 'https://<YOUR_DEPLOYED_DOMAIN>/v1beta/models/gemini-2.5-pro:generateContent' \
--header 'Content-Type: application/json' \
--header 'x-goog-api-key: <YOUR_GEMINI_API_KEY_1>,<YOUR_GEMINI_API_KEY_2>' \
--data '{
    "contents": [
        {
         "role": "user",
         "parts": [
            {
               "text": "Hello"
            }
         ]
      }
    ]
}'

请将 <YOUR_DEPLOYED_DOMAIN> 替换为您的实际域名，<YOUR_GEMINI_API_KEY_x> 替换为实际 Key。

方式 B：OpenAI 兼容格式 (Curl)

curl -X POST --location 'https://<YOUR_DEPLOYED_DOMAIN>/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_GEMINI_API_KEY>' \
--data '{
    "model": "gpt-3.5-turbo",
    "messages": [
        {
            "role": "user",
            "content": "你好"
        }
    ]
}'

方式 C：验证 API Key 有效性

curl -X POST --location 'https://<YOUR_DEPLOYED_DOMAIN>/verify' \
--header 'x-goog-api-key: <YOUR_GEMINI_API_KEY_1>,<YOUR_GEMINI_API_KEY_2>'