Gemini Balance 安装与配置指南
【免费下载链接】gemini-balance gemini轮询代理服务 
项目地址: https://gitcode.com/GitHub_Trending/ge/gemini-balance
项目基础介绍
Gemini Balance 是一个基于 Python FastAPI 构建的开源应用程序，专门为 Google Gemini API 提供代理和负载均衡功能。该项目能够管理多个 Gemini API 密钥，实现密钥轮换、身份验证、模型过滤和状态监控等功能。同时，项目还集成了图像生成和多种图床上传功能，并支持以 OpenAI API 格式进行代理。
项目使用的关键技术和框架
- FastAPI: 用于构建 API 的现代、高性能 Web 框架
- SQLAlchemy: Python SQL 工具包和对象关系映射系统
- uvicorn: ASGI 服务器，用于运行 FastAPI 应用
- Docker: 容器化技术，便于部署和运维
项目安装和配置的准备工作及详细步骤
准备工作
在开始安装前，请确保系统满足以下要求：
- Python 3.9 或更高版本
- MySQL 数据库服务
- Docker 容器平台（推荐使用）
安装步骤
使用 Docker Compose 部署（推荐方法）
-
获取项目源码：
git clone https://gitcode.com/GitHub_Trending/ge/gemini-balance.git cd gemini-balance -
准备环境配置文件： 复制项目中的示例配置文件并修改相应参数
-
启动服务：
docker-compose up -d
使用 Docker 命令部署
-
拉取镜像：
docker pull ghcr.io/snailyp/gemini-balance:latest -
运行容器：
docker run -d -p 8000:8000 --name gemini-balance --env-file .env ghcr.io/snailyp/gemini-balance:latest
本地开发环境部署
-
克隆并安装项目：
git clone https://gitcode.com/GitHub_Trending/ge/gemini-balance.git cd gemini-balance pip install -r requirements.txt -
配置环境变量： 创建
.env文件并设置必要的配置参数 -
启动应用程序：
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
环境配置详解
创建 .env 配置文件，包含以下核心参数：
API_KEYS=["your-gemini-key-1", "your-gemini-key-2"]
MYSQL_HOST=your-database-host
ALLOWED_TOKENS=["your-access-token"]
主要配置项说明：
- 数据库配置：设置 MySQL 连接参数，包括主机、端口、用户名、密码和数据库名
- API 密钥管理：配置多个 Gemini API 密钥实现负载均衡
- 访问令牌：设置允许访问的令牌列表
- 模型配置：定义支持图像生成、搜索等功能的模型
功能特性展示
Gemini Balance 提供了丰富的功能特性：
多密钥负载均衡 支持配置多个 Gemini API 密钥进行自动顺序轮询，确保服务的高可用性。
图像文本聊天与修改 通过配置 IMAGE_MODELS 支持图像文本聊天和编辑功能，使用 configured_model-image 模型名称进行调用。
Web 搜索功能 配置 SEARCH_MODELS 支持网页搜索，使用 configured_model-search 模型名称进行调用。
密钥状态监控 提供 /keys_status 页面（需要身份验证）进行实时监控。
详细日志记录 提供详细的错误日志，便于故障排查。
灵活密钥添加 使用 gemini_key 正则表达式批量添加密钥，自动去重。
API 端点说明
Gemini API 格式 (/gemini/v1beta)
此端点直接转发到官方 Gemini API 格式端点，不包含高级功能。
GET /models: 列出可用的 Gemini 模型POST /models/{model_name}:generateContent: 生成内容POST /models/{model_name}:streamGenerateContent: 流式内容生成
OpenAI API 格式
Hugging Face (HF) 兼容
如果想要使用高级功能，如模拟流式传输，请使用此端点。
GET /hf/v1/models: 列出模型POST /hf/v1/chat/completions: 聊天完成POST /hf/v1/embeddings: 创建文本嵌入POST /hf/v1/images/generations: 生成图像
标准 OpenAI
此端点直接转发到官方 OpenAI 兼容 API 格式端点，不包含高级功能。
GET /openai/v1/models: 列出模型POST /openai/v1/chat/completions: 聊天完成（推荐）POST /openai/v1/embeddings: 创建文本嵌入POST /openai/v1/images/generations: 生成图像
验证与访问
服务启动后，可以通过浏览器访问 http://localhost:8000 进入 Gemini Balance 管理界面。
核心功能模块位置：
- API 路由定义：app/router/
- 负载均衡逻辑：app/core/
- 配置管理：app/config/
使用技巧与最佳实践
- 性能优化：合理设置 API 密钥数量避免频率限制
- 监控配置：定期检查负载均衡状态和密钥使用情况
- 日志分析：利用内置日志功能优化 API 调用策略
通过以上步骤，你已经成功部署了功能完整的 Gemini Balance 服务，现在可以开始享受智能 API 管理和负载均衡带来的便利了！
【免费下载链接】gemini-balance gemini轮询代理服务 项目地址: https://gitcode.com/GitHub_Trending/ge/gemini-balance
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
