一个专为Gemini多Key轮询设计的 Gemini API 代理服务，通过智能轮询多个 API Key 突破单Key限制，提供 OpenAI 兼容接口和完整的管理界面。无需服务器，一键免费部署到 Render 平台，立即获得公网访问地址。
- 🔄 智能轮询：多个 Gemini API Key 自动轮询，突破单Key请求限制
- 🛡️ 高可用性：单个Key失效不影响服务，自动故障转移
- 🚀 一键部署：Fork 仓库后直接在 Render 部署，10分钟获得公网地址
- 💰 完全免费：使用 Render 免费层，无需支付内网穿透或映射服务器费用
- 📊 可视化管理：Streamlit 构建的直观管理界面
- ⚡ 高性能：FastAPI + 异步处理，支持流式响应
- 🔐 安全可靠：用户密钥管理、使用统计、速率限制
- 🎨 多模态支持：原生支持 Gemini 2.5 的图片、音频、视频、文档处理能力
- 智能符号注入：自动在请求中注入不可见的Unicode符号，避免被检测为自动化请求
- 多种注入策略：支持前缀、后缀、包裹等多种注入模式，智能随机切换
- 符号库优化：精选数百个安全的Unicode符号，包括数学符号、几何图形、装饰符号等
- 请求去重：智能识别重复请求，使用不同策略处理，提高防检测效果
- 三种响应模式：
- 自动模式：根据客户端请求智能选择，提供最佳兼容性
- 强制流式：所有响应使用流式输出，实现打字机效果，提升用户体验
- 强制非流式：等待完整响应后返回，适合批处理和自动化场景
- 实时切换：无需重启服务即可切换模式
- 零延迟切换：API Key失败时立即切换到下一个，无需等待重试
- 智能选择：自动跳过不健康的Key，优先使用性能最佳的Key
- 后台健康检测：失败的Key在后台进行健康检测，恢复后自动加入轮询池
- 可配置策略：
- 最大尝试Key数量（1-20个）
- 健康检测延迟时间（1-60秒）
- 后台检测开关
- 性能提升：故障转移时间从原来的15-30秒降低到2-10秒
- 响应式设计：完美适配手机、平板等各种移动设备
- 触摸优化：专为触屏设备优化的交互体验
- 移动端布局：针对小屏幕优化的紧凑布局和字体大小
- Gemini 2.5 完整能力：支持文本、图片、音频、视频、文档全类型处理
- 文件上传 API：提供
/v1/files端点，支持最大100MB文件上传 - 智能文件处理：
- 📷 图片：PNG, JPG, JPEG, GIF, WebP, BMP
- 🎵 音频：MP3, WAV, M4A, FLAC, AAC, OGG
- 🎬 视频：MP4, AVI, MOV, WebM, QuickTime
- 📄 文档：PDF, TXT, CSV, DOCX, XLSX
- 内联数据优化：小文件(<20MB)使用内联传输，大文件自动使用Gemini File API
- 异常Key检测：自动监控API Key健康状态，识别连续异常的Key
- 自动清理策略：可配置连续异常天数阈值，自动移除问题Key
- 安全保护机制：
- 🛡️ 保留至少1个健康Key，确保服务不中断
- 📊 检测次数保护，避免因监控数据不足导致误删
- 🔄 软删除设计，被清理的Key可随时恢复
- 风险预警：实时显示处于风险状态的Key，提前预警
- 灵活配置：可自定义清理阈值、检测频率等参数
- 视觉升级：采用现代玻璃拟态设计风格，半透明模糊效果带来美观的视觉体验
- 动态背景：渐变动画背景，让管理界面充满活力
- 细节优化：精心设计的卡片、按钮、输入框等组件，每个交互都赏心悦目
- 响应式布局：完美适配各种屏幕尺寸，移动端也能优雅使用
- 实时监测：自动检测所有Gemini API Key的健康状态
- 故障识别：连续失败自动标记为异常，避免请求浪费
- 一键检测：支持手动触发全量健康检查
- 可视化状态：直观的健康指示器，绿色正常、红色异常、黄色未知
- 批量添加apikey：支持正则匹配大量key实现一键添加
- 智能选择：根据成功率和响应时间自动选择最优Key，同时实现了自动的故障转移，遇到超额key返回429时自动调用其它key重试，直到返回正确结果
- 性能权重：综合考虑成功率和响应速度
- 动态调整：实时更新Key性能指标，确保始终使用最佳Key
- 策略切换：支持在自适应、最少使用、轮询三种策略间切换
点击页面右上角的 Fork 按钮，将本项目复制到你的 GitHub 账户下。
- 访问 Render.com
- 使用 GitHub 账户登录（推荐）或邮箱注册
- 需要MasterCard或VisaCard验证身份！但完全免费
- 在 Render 控制台点击 "New +" → "Blueprint"
- 选择 "Connect a repository"
- 找到你刚刚 Fork 的
gemini-api-proxy仓库，点击 "Connect" - 配置 Blueprint 参数：
Name: gemini-api-services # 自定义Blueprint名称
Branch: main-
Render 会自动识别
render.yaml文件并显示将要创建的服务：- ✅ gemini-api-proxy (后端API服务)
- ✅ gemini-proxy-admin (前端管理界面)
-
点击 "Apply" 开始部署
- ⏱️ 首次部署时间：约5-10分钟
- 📊 部署进度：可在Dashboard中实时查看两个服务的构建状态
- ✅ 完成标志：两个服务都显示绿色的"Live"状态
由于Render免费层的限制，需要手动配置前后端连接：
- 在Render Dashboard中找到 gemini-api-proxy 服务
- 复制其完整URL，格式类似：
https://gemini-api-proxy-xxx.onrender.com
- 点击进入 gemini-proxy-admin 服务
- 转到 "Environment" 标签页
- 添加环境变量：
Key: API_BASE_URL Value: https://gemini-api-proxy-xxx.onrender.com - 点击 "Save Changes"
- 前端会自动重新部署（约2-3分钟）
访问 https://gemini-proxy-admin-xxx.onrender.com
你将看到 Streamlit 管理界面，现在可以开始配置 API 密钥了！
Q: 为什么不能完全自动连接前后端？ A: Render免费层的Blueprint功能在服务引用方面有限制，无法自动构建完整的HTTPS URL。
Q: 如果前端无法连接后端怎么办？ A: 检查以下几点：
- 后端服务是否正常运行（访问/health端点）
- API_BASE_URL环境变量是否设置正确
- URL格式是否包含https://前缀
Q: 可以自定义服务名称吗？ A: 可以！修改render.yaml中的name字段，然后重新同步Blueprint。
轮询的核心是配置多个API Key，建议至少添加3-5个Key：
- 访问前端管理界面
- 进入 "密钥管理" → "Gemini 密钥" 页面
- 逐个添加多个 Gemini API Key：
Key 1: AIzaSyXXXXXXXXXXXXXXXXXXXXXX
Key 2: AIzaSyYYYYYYYYYYYYYYYYYYYYYY
Key 3: AIzaSyZZZZZZZZZZZZZZZZZZZZZZ
... 更多Key
- API Key 获取方式：
- 访问 Google AI Studio
- 登录并创建新的 API Key
- 复制密钥（格式：
AIzaSy...） - 建议创建多个项目，每个项目生成一个Key
💡 配置建议：
- ✅ 至少3个Key：保证基本的轮询效果
- ✅ 5-10个Key：获得更高的请求限制和稳定性
- ✅ 不同项目的Key：降低同时被限制的风险
- 进入 "系统设置" → "轮询配置" 页面
- 选择轮询策略：
- Round Robin：按顺序轮询，负载分配均匀
- Least Used（推荐）：智能选择使用量最少的Key
- 设置故障转移：自动跳过失效的Key
- 在管理界面进入 "密钥管理" → "用户密钥" 页面
- 点击 "生成新密钥"，输入密钥名称
- 立即保存生成的密钥（格式：
sk-...），它不会再次显示
- 进入 "系统设置" → "思考模式" 页面
- 启用思考模式以获得更好的推理能力
- 选择合适的思考预算：
- 自动：让模型自动决定
- 2.5flash最大思考预算 (24k)：快速响应
- 2.5pro最大思考预算 (32k)：深度思考
配置完成后，你就可以使用 OpenAI SDK 访问轮询代理了。系统会自动在多个 Gemini Key 之间进行轮询，提供更高的请求限制和稳定性。
# 上传文件
curl -X POST "http://localhost:8000/v1/files" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@image.jpg"
# 响应示例
{
"id": "file-abc123",
"object": "file",
"bytes": 1024000,
"created_at": 1703123456,
"filename": "image.jpg",
"purpose": "multimodal"
}import openai
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="http://localhost:8000/v1"
)
# 文本 + 图片对话
response = client.chat.completions.create(
model="gemini-2.5-flash",
messages=[
{
"role": "user",
"content": [
{
"type": "text",
"text": "这张图片里有什么？"
},
{
"type": "image",
"file_data": {
"file_id": "file-abc123",
"mime_type": "image/jpeg"
}
}
]
}
]
)
print(response.choices[0].message.content)| 类型 | 支持格式 | 最大大小 | 用途 |
|---|---|---|---|
| 图片 | PNG, JPG, JPEG, GIF, WebP | 100MB | 图像识别、分析、描述 |
| 音频 | MP3, WAV, M4A, FLAC | 100MB | 语音转文字、音频分析 |
| 视频 | MP4, AVI, MOV, WebM | 100MB | 视频内容分析、帧提取 |
| 文档 | 100MB | 文档解析、内容提取 |
遇到问题或想要交流经验？欢迎加入我们的QQ群：
- 📊 轮询效率监控：实时查看每个Key的使用分布
- 📈 聚合请求统计：所有Key的总体请求量图表
- 🔍 Key状态分析：快速识别失效或过载的Key
- 💹 限制倍增显示：直观展示轮询带来的限制提升
- 🔑 多Key轮询管理：批量添加、启用/禁用Gemini API Key
- 🔄 轮询状态监控：查看每个Key的轮询参与状态
- 👤 用户访问密钥生成：为客户端生成访问令牌
- 🚦 智能故障检测：自动识别并跳过失效Key
- ⚖️ 负载均衡策略：Round Robin / Least Used 策略切换
- 🎯 Key权重设置：为不同Key设置不同的使用权重
- 🛡️ 故障转移配置：设置Key失效时的自动切换策略
- 📊 使用率阈值：单Key使用率预警和保护
- ⚙️ 单Key限制设置：配置每个Key的RPM/TPM限制
- 📊 总限制计算：自动计算轮询后的总体限制
- 🔧 模型状态管理：启用/禁用特定模型的轮询
- 🧠 思考模式配置
- 📝 提示词注入
- 📋 系统状态监控
- ⏰ 运行时间：每月 750 小时
- 📶 带宽：每月 100GB 出站流量
- 💾 数据库：1GB PostgreSQL（90天）
- 🌍 域名：免费
.onrender.com子域名 - 🔒 HTTPS：自动 SSL 证书
- 🛌 休眠机制：15分钟无请求后自动休眠
- ⚡ 冷启动：休眠后首次请求需要15-30秒唤醒
- 🔄 自动重启：系统可能随时重启服务
Render 免费层支持自定义域名：
- 在服务设置中添加自定义域名
- 在域名提供商处添加 CNAME 记录
- Render 自动提供 SSL 证书
| 变量名 | 说明 | 默认值 |
|---|---|---|
API_BASE_URL |
后端API地址 | - |
PORT |
服务端口 | 自动分配 |
PYTHONUNBUFFERED |
Python输出缓冲 | 1 |
- 🔑 Key数量建议：3-10个Key为最佳，过多Key管理复杂
- 🌍 Key来源分散：使用不同Google账号和项目创建Key
- 📊 监控使用率：定期检查Key使用分布，确保轮询效果
- 🔄 及时替换：发现失效Key立即替换，保持轮询池健康
- ⚖️ 策略选择：高并发场景用Round Robin，日常使用Least Used
- 🔐 用户密钥仅显示一次，请立即保存
- 🚫 不要在客户端直接使用 Gemini API Key
- 🔒 定期轮换所有 API 密钥
- 🛡️ 多Key轮询降低单点安全风险
Q: 需要多少个Key才有轮询效果？ A: 至少2个Key，推荐3-5个Key获得最佳平衡。
Q: 某个Key失效了怎么办？ A: 系统自动跳过失效Key，继续使用其他Key，服务不中断。
Q: 如何知道轮询是否在工作？ A: 在管理界面可以看到每个Key的使用分布和轮询状态。
Q: 服务访问很慢怎么办？ A: 这是 Render 免费层的冷启动特性，等待15-30秒即可恢复正常。
Q: 如何避免服务休眠？ A: 服务可能会因为无请求而休眠，首次访问需要等待唤醒。
Q: 可以商用吗？ A: 本项目采用 CC BY-NC 4.0 许可证，仅允许非商业使用。
- Python 3.8+
- pip
pip install -r requirements.txtpython run_server.pystreamlit run main.pyAPI Key 加密存储 - 当前明文存储存在一定安全风险
数据持久化方案 - 解决 Render 重启丢失数据问题
自动 Key 健康检测 - 检查到 Key 连续三天失效自动移至移除区
优化 Key 使用策略 - 自适应负载均衡，选择最优配置
确保部署保证简单与免费的特性
本项目采用 CC BY-NC 4.0 许可证。
- ✅ 允许：分享、修改、分发
- ❌ 禁止：商业使用
- 📝 要求：署名原作者
欢迎提交 Issue 和 Pull Request！
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
推一推另一个好玩的App！https://github.com/Arain119/ChatApp ，超强的角色扮演能力~
- Google Gemini - 强大的AI模型
- Render - 优秀的免费部署平台
- FastAPI - 现代Python Web框架
- Streamlit - 快速构建数据应用