Gemini Balance：谷歌Gemini API代理与负载均衡神器，告别限速，玩转多模态AI！

在AI应用开发浪潮中，高效管理API调用是成功的关键。Gemini Balance应运而生，作为一款强大的开源Google Gemini API代理与负载均衡器，它专为解决多Key管理、速率限制和高可用性挑战而设计。通过智能轮询、实时监控和灵活兼容性，Gemini Balance赋能开发者轻松构建稳定、高性能的Gemini服务栈，全面释放多模态AI的潜力。

告别API限速困扰：Gemini Balance的核心优势

Gemini Balance以Python和FastAPI为核心，巧妙整合多Key轮询、负载均衡、权限过滤与健康监控，并向下兼容OpenAI接口格式。最新版本在性能、文档与安全性上全面升级，引入countTokens端点、自动思考配置优化、本地与云端双向代理指南，以及ARM/AMD Docker镜像，帮助开发者快速构建高可用的Gemini服务栈。

智能多Key轮询与负载均衡

Gemini Balance支持在同一实例中管理多组Gemini API Key，并通过轮询算法智能分摊流量。这显著降低了单Key触发速率限制的风险，确保您的应用持续稳定运行，有效提升并发处理能力。系统自动按顺序轮询多个Gemini API Key，从而均衡请求负载。

您可以配置最大重试次数与失败自动禁用策略，系统会定时检测并恢复失效的Key。这种机制极大地提升了服务的韧性。

实时状态监控与安全保障

Gemini Balance提供认证访问的keys_status页面，实时展示各Key的使用情况与健康指标。详细的日志记录功能帮助您快速排查错误与性能瓶颈，确保服务透明可控。

相比上游版本，当前Fork进一步修复了配置缺陷，强化了安全策略。同时，补全了繁体中文与英文文档，方便跨地区团队协作，提升了项目的国际化水平。

灵活的协议与模型支持

Gemini Balance同时兼容Gemini和OpenAI格式的CHAT、画图及embeddings接口。这意味着您可以无缝迁移现有OpenAI应用，并充分利用Gemini的最新多模态能力。它支持IMAGE_MODELS、SEARCH_MODELS等配置，分别用于图文对话、联网搜索和修图功能。

您可以过滤不常用模型，并且系统能够自动从API获取最新的模型列表，确保您的应用始终与最新的AI能力保持同步。countTokens API支持在发送前预估token数量，帮助您更好地管理成本和优化请求。

新增与优化功能亮点

最新版本引入了智能thinkingConfig处理，当thinkingBudget为0时，它会自动省略该配置。这进一步优化了API调用，减少了不必要的参数传递。

反向代理与本地开发指南详细包含了nginx、SSL证书、hosts配置等。这些指南为开发者提供了清晰的部署和开发路径。管理脚本支持一键切换代理、更新端口与完整移除，简化了运维操作。

技术实现与兼容性：构建稳健的AI服务栈

Gemini Balance在技术实现上追求高效与灵活，旨在为开发者提供一个坚实可靠的AI服务基础。

强大的技术栈与架构

项目以Python和FastAPI为核心，利用其异步特性高效处理并发请求，性能表现优于传统同步框架。这确保了在高并发场景下，Gemini Balance依然能够稳定响应。

Nginx、SSL和mkcert官方示例脚本支持一键生成本地证书，快速配置HTTPS反向代理。这使得本地开发和部署更加便捷，同时保障了数据传输的安全性。

容器化部署与广泛兼容性

官方镜像适配AMD与ARM架构，用户只需执行docker pull ghcr.io/snailyp/gemini-balance:latest即可落地生产环境。您也可以自行构建镜像，定制插件，以满足特定的业务需求。

Gemini Balance可为每个请求单独指定HTTPS/SOCKS5代理，亦支持将Gemini官方或自建Cloudflare Worker代理作为上游端点。这种灵活性使其能够适应各种复杂的网络场景。

适用场景：谁需要Gemini Balance？

无论您是个人开发者还是企业团队，Gemini Balance都能为您带来巨大价值。

个人或团队需要统一管理多把Gemini Key，以提升调用上限，避免因单Key限速而影响开发进度。AI应用希望无缝迁移自OpenAI，同时兼顾Gemini最新的多模态能力，实现技术栈的平滑过渡。

对于对安全合规、可观测性与高可用性有硬性要求的生产部署，Gemini Balance提供了稳定可靠的解决方案，确保您的AI服务在生产环境中表现出色。

快速上手：立即体验Gemini Balance

借助Gemini Balance，您可以在最短时间内获得稳定、易扩展且对开发者友好的Gemini代理服务。为您的应用接入最新多模态模型扫清障碍，开启智能应用的新篇章。

部署与配置指南

• OpenAI 格式：curl http://localhost:8000/v1/chat/completions -H "Authorization: Bearer sk-..."
• Gemini 格式：curl http://localhost:8000/gemini/v1beta/models/gemini-pro:generateContent

两种协议均支持图文对话、联网搜索与自定义模型过滤，让您的AI应用开发更加得心应手。立即行动，让Gemini Balance成为您AI开发旅程中的得力助手！