186 lines
5.5 KiB
Markdown
186 lines
5.5 KiB
Markdown
# Gemini Balance Lite
|
||
# Gemini API 代理和负载均衡无服务器轻量版（边缘函数）
|
||
|
||
### 作者：技术爬爬虾
|
||
[B站](https://space.bilibili.com/316183842)，[Youtube](https://www.youtube.com/@Tech_Shrimp)，抖音，公众号 全网同名。转载请注明作者。
|
||
|
||
|
||
## 项目简介
|
||
|
||
Gemini API 代理, 使用边缘函数把Gemini API免费中转到国内。还可以聚合多个Gemini API Key，随机选取API Key的使用实现负载均衡，使得Gemini API免费成倍增加。
|
||
|
||
## Vercel部署(推荐)
|
||
[](https://vercel.com/new/clone?repository-url=https://github.com/tech-shrimp/gemini-balance-lite)
|
||
|
||
|
||
1. 点击部署按钮⬆️一键部署。
|
||
2. 国内使用需要配置自定义域名
|
||
<details>
|
||
<summary>配置自定义域名：</summary>
|
||
|
||
|
||
</details>
|
||
3. 去[AIStudio](https://aistudio.google.com)申请一个免费Gemini API Key
|
||
<br>将API Key与自定义的域名填入AI客户端即可使用，如果有多个API Key用逗号分隔
|
||
<details>
|
||
<summary>以Cherry Studio为例：</summary>
|
||
|
||
|
||
</details>
|
||
|
||
|
||
|
||
|
||
## Deno部署
|
||
|
||
1. [fork](https://github.com/tech-shrimp/gemini-balance-lite/fork)本项目
|
||
2. 登录/注册 https://dash.deno.com/
|
||
3. 创建项目 https://dash.deno.com/new_project
|
||
4. 选择此项目，填写项目名字（请仔细填写项目名字，关系到自动分配的域名）
|
||
5. Entrypoint 填写 `src/deno_index.ts` 其他字段留空
|
||
<details>
|
||
<summary>如图</summary>
|
||
|
||
|
||
</details>
|
||
6. 点击 <b>Deploy Project</b>
|
||
7. 部署成功后获得域名
|
||
8. 国内使用需要配置自定义域名
|
||
9. 去[AIStudio](https://aistudio.google.com)申请一个免费Gemini API Key
|
||
10. 将API Key与分配的域名填入AI客户端即可使用，如果有多个API Key用逗号分隔
|
||
|
||
<details>
|
||
<summary>以Cherry Studio为例：</summary>
|
||
|
||
|
||
</details>
|
||
|
||
|
||
## Cloudflare Worker 部署
|
||
[](https://deploy.workers.cloudflare.com/?url=https://github.com/tech-shrimp/gemini-balance-lite)
|
||
|
||
0. CF Worker有可能会分配香港的CDN节点导致无法使用(Gemini不允许香港IP连接)
|
||
0. 广东地区不建议使用Cloudflare Worker 部署
|
||
1. 点击部署按钮
|
||
2. 登录Cloudflare账号
|
||
3. 链接Github账户，部署
|
||
4. 打开dash.cloudflare.com，查看部署后的worker
|
||
6. 国内使用需要配置自定义域名
|
||
<details>
|
||
<summary>配置自定义域名：</summary>
|
||
|
||
|
||
</details>
|
||
|
||
|
||
## Netlify部署
|
||
[](https://app.netlify.com/start/deploy?repository=https://github.com/tech-shrimp/gemini-balance-lite)
|
||
<br>点击部署按钮，登录Github账户即可
|
||
<br>免费分配域名，国内可直连。
|
||
<br>但是不稳定
|
||
|
||
<details>
|
||
<summary>将分配的域名复制下来，如图：</summary>
|
||
|
||
|
||
</details>
|
||
|
||
去[AIStudio](https://aistudio.google.com)申请一个免费Gemini API Key
|
||
<br>将API Key与分配的域名填入AI客户端即可使用，如果有多个API Key用逗号分隔
|
||
|
||
<details>
|
||
<summary>以Cherry Studio为例：</summary>
|
||
|
||
|
||
</details>
|
||
|
||
|
||
|
||
## 打赏
|
||
#### 帮忙点点关注点点赞，谢谢啦~
|
||
B站：[https://space.bilibili.com/316183842](https://space.bilibili.com/316183842)<br>
|
||
Youtube: [https://www.youtube.com/@Tech_Shrimp](https://www.youtube.com/@Tech_Shrimp)
|
||
|
||
|
||
## 本地调试
|
||
|
||
1. 安装NodeJs
|
||
2. npm install -g vercel
|
||
3. cd 项目根目录
|
||
4. vercel dev
|
||
|
||
## API 说明
|
||
|
||
|
||
### Gemini 代理
|
||
|
||
可以使用 Gemini 的原生 API 格式进行代理请求。
|
||
**Curl 示例:**
|
||
```bash
|
||
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 示例:（流式）**
|
||
```bash
|
||
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 示例:**
|
||
```bash
|
||
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` 端点来发送请求。
|
||
|
||
**Curl 示例:**
|
||
```bash
|
||
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": "你好"
|
||
}
|
||
]
|
||
}'
|
||
```
|
||
|