Gemini Balance 使用与启动教程

Gemini Balance 使用与启动教程

gemini-balance gemini轮询代理服务 项目地址: https://gitcode.com/gh_mirrors/ge/gemini-balance

1. 项目介绍

Gemini Balance 是一个基于 Python FastAPI 开发的应用程序，主要用于提供 Google Gemini API 的代理和负载均衡功能。它允许用户管理多个 Gemini API Key，通过轮询、认证、模型过滤和状态监控来优化 API 使用。此外，Gemini Balance 还支持图像生成、图床上传、OpenAI API 格式的代理等多种功能。

2. 项目快速启动

2.1 环境准备

• 克隆仓库到本地：git clone https://github.com/snailyp/gemini-balance.git
• 安装 Python 3.9 或更高版本
• 在项目根目录下创建并配置好 .env 文件

2.2 使用 Docker 启动

构建镜像

docker build -t gemini-balance .

运行容器

docker run -d -p 8000:8000 --env-file .env gemini-balance

• -d：后台运行
• -p 8000:8000：将容器的 8000 端口映射到主机的 8000 端口
• --env-file .env：使用 .env 文件设置环境变量

2.3 本地运行

安装项目依赖

pip install -r requirements.txt

启动应用

uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

• app.main:app：指定 FastAPI 应用实例的位置
• --host 0.0.0.0：使应用可以从本地网络中的任何 IP 地址访问
• --port 8000：指定应用监听的端口号
• --reload：启用自动重载功能（适合开发环境）

3. 应用案例和最佳实践

• 多 Key 负载均衡：通过配置多个 Gemini API Key 来提高系统的可用性和并发能力。
• 可视化配置：通过管理后台实时修改配置，无需重启服务即可生效。
• Key 状态监控：通过 /keys_status 页面实时监控 Key 的状态和使用情况。

4. 典型生态项目

• OneLine：AI驱动的热点事件时间轴生成工具。

以上是 Gemini Balance 的基本介绍和使用教程，希望对您有所帮助。

gemini-balance gemini轮询代理服务 项目地址: https://gitcode.com/gh_mirrors/ge/gemini-balance