beijixingxing/hajimi repository overview

⁠🚀 Gemini API 代理服务 (OpenAI 兼容版)

⁠一个基于 FastAPI 构建的高效代理服务，提供安全可靠的 Google Gemini 模型访问通道，完美兼容 OpenAI API 格式。

项目地址: https://github.com/wyeeeee/hajimi⁠
部署指南: Docker 部署教程⁠

⁠✨ 核心特性

⁠🔌 无缝兼容

• 完全兼容 OpenAI API 格式 (/v1/chat/completions)
• 自动请求转换：OpenAI → Gemini 格式
• 支持流式(streaming)和非流式响应

⁠🔒 企业级安全

• 可选密码保护 (通过 PASSWORD 环境变量配置)
• API 密钥轮询机制 (支持多密钥负载均衡)
• 智能速率限制系统 (IP/全局/密钥多维度)

⁠⚡ 高性能配置

• 多 API 密钥自动轮换 (GEMINI_API_KEYS=key1,key2)
• 双模支持：AI Studio + Vertex AI (ENABLE_VERTEX)
• 实时流模拟 (FAKE_STREAMING=true)

⁠🛠️ 环境配置

# 安全配置
PASSWORD=your_strong_password  # 访问密码
SKIP_CHECK_API_KEY=false       # 跳过API KEY验证

# Gemini 核心
GEMINI_API_KEYS=key1,key2      # 多KEY轮询
API_KEY_DAILY_LIMIT=100        # 单KEY日限额

# 流量控制
MAX_REQUESTS_PER_MINUTE=30     # 全局QPM限制
MAX_REQUESTS_PER_DAY_PER_IP=600 # IP日限额

# Vertex AI
ENABLE_VERTEX=true            # 启用Vertex
GOOGLE_CREDENTIALS_JSON='...' # 服务账号凭证

⁠📌 最佳实践建议

1. 安全部署：务必设置高强度 PASSWORD 并定期轮换
2. 容量规划：根据业务需求调整 API_KEY_DAILY_LIMIT
3. 性能调优：合理配置 MAX_REQUESTS_* 系列参数
4. 监控建议：关注 API 密钥使用量及配额情况