dumplingmiku/gemini-balance-lite

Fork 0

tech-shrimp db158715a8 修改CURL 为post

2025-08-03 22:10:40 +08:00

5.5 KiB

Raw Permalink Blame History

Gemini Balance Lite

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

作者：技术爬爬虾

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

项目简介

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

Vercel部署(推荐)

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

配置自定义域名：
去AIStudio申请一个免费Gemini API Key
将API Key与自定义的域名填入AI客户端即可使用，如果有多个API Key用逗号分隔

以Cherry Studio为例：

Deno部署

fork本项目
登录/注册 https://dash.deno.com/
创建项目 https://dash.deno.com/new_project
选择此项目，填写项目名字（请仔细填写项目名字，关系到自动分配的域名）
Entrypoint 填写 src/deno_index.ts 其他字段留空

如图
点击 Deploy Project
部署成功后获得域名
国内使用需要配置自定义域名
去AIStudio申请一个免费Gemini API Key
将API Key与分配的域名填入AI客户端即可使用，如果有多个API Key用逗号分隔

以Cherry Studio为例：

Cloudflare Worker 部署

CF Worker有可能会分配香港的CDN节点导致无法使用(Gemini不允许香港IP连接)
广东地区不建议使用Cloudflare Worker 部署
点击部署按钮
登录Cloudflare账号
链接Github账户，部署
打开dash.cloudflare.com，查看部署后的worker
国内使用需要配置自定义域名

配置自定义域名：

Netlify部署

点击部署按钮，登录Github账户即可
免费分配域名，国内可直连。
但是不稳定

将分配的域名复制下来，如图：

去AIStudio申请一个免费Gemini API Key
将API Key与分配的域名填入AI客户端即可使用，如果有多个API Key用逗号分隔

以Cherry Studio为例：

打赏

帮忙点点关注点点赞，谢谢啦~

B站：https://space.bilibili.com/316183842
Youtube: https://www.youtube.com/@Tech_Shrimp

本地调试

安装NodeJs
npm install -g vercel
cd 项目根目录
vercel dev

API 说明

Gemini 代理

可以使用 Gemini 的原生 API 格式进行代理请求。 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"
            }
         ]
      }
    ]
}'

Curl 示例:（流式）

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"
            }
         ]
      }
    ]
}'

注意: 请将 <YOUR_DEPLOYED_DOMAIN> 替换为你的部署域名，并将 <YOUR_GEMINI_API_KEY> 替换为你的 Gemini API Ke，如果有多个用逗号分隔

API Key 校验

可以通过向 /verify 端点发送请求来校验你的 API Key 是否有效。可以一次性校验多个 Key，用逗号隔开。

Curl 示例:

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

OpenAI 格式

本项目兼容 OpenAI 的 API 格式，你可以通过 /chat 或 /chat/completions 端点来发送请求。