yukkcat GitHub avatar

gemini-business2api

Python
Gemini 转 OpenAI 接口yukkcat最近推送 2026年5月22日
模型推理与部署NOASSERTION1,33489037 issues

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日

把 Gemini Business 转成 OpenAI 兼容 API 的网关,支持多账号负载均衡和多模态能力。

这是一个用 Python 写的网关服务,将 Gemini Business 的能力包装成 OpenAI 兼容接口,方便现有 OpenAI SDK 或中间层直接调用。它内置管理后台,可以管理账号池、系统设置、图片/视频生成和运行状态,支持 SQLite 或 PostgreSQL 存储。

推荐指数

3.0

适合需要把 Gemini Business 接入 OpenAI 生态的开发者,但要注意非商业许可和账号来源合规性。

总 Star 排名

#2925

雷达追踪的 3,958 个 AI 仓库中

创建于

2025

2025年12月24日

核心亮点

  • 1OpenAI 兼容

    提供 /v1/chat/completions、/v1/models 等标准接口,可直接对接常见 OpenAI SDK。

  • 2多账号调度

    支持轮询、可用性切换和批量管理账号,提升服务稳定性。

  • 3多模态能力

    覆盖文本、文件解析、图片生成/编辑和视频生成。

  • 4管理后台

    内置仪表盘、账号管理、监控、日志和画廊,方便运维。

  • 5部署灵活

    支持 Docker Compose 一键部署,也可用交互式脚本安装。

适用场景

  • 接入 OpenAI 生态

    例如:已有基于 OpenAI SDK 的应用,想低成本切换到 Gemini Business 后端。

  • 多账号池管理

    例如:团队有多个 Gemini Business 账号,需要统一调度和监控使用情况。

  • 多模态应用开发

    例如:开发需要图片生成、视频生成或文件解析的 AI 应用。

它是怎么工作的

  1. 第 1 步

    接收请求

    网关监听 OpenAI 兼容接口,接收客户端发来的对话、图片或视频请求。

  2. 第 2 步

    调度账号

    根据账号池状态和调度策略,选择可用账号转发请求到 Gemini Business。

  3. 第 3 步

    转换响应

    将 Gemini Business 的返回结果转换为 OpenAI 兼容格式返回给客户端。

  4. 第 4 步

    记录与监控

    请求日志、账号状态和生成内容存入数据库,并在管理后台展示。

快速上手

  1. 1

    克隆仓库

    下载项目代码到本地。

    git clone https://github.com/yukkcat/gemini-business2api.git && cd gemini-business2api
  2. 2

    配置环境变量

    复制示例配置并至少设置 ADMIN_KEY。

    cp .env.example .env
  3. 3

    启动服务

    使用 Docker Compose 启动主服务。

    docker compose up -d
  4. 4

    访问后台

    打开管理后台地址,默认端口 7860。

适合谁

  • 需要将 Gemini Business 接入 OpenAI 兼容接口的开发者
  • 有多个 Gemini Business 账号需要统一管理的团队
  • 需要图片/视频生成等多模态能力的应用开发者

不太适合

  • 希望用于商业闭源产品的团队(许可证为非商业)
  • 没有 Gemini Business 账号或无法合规获取账号的用户

成熟度

  • 活跃度最近一次推送在 2026 年 5 月,版本迭代到 v0.3.3,活跃度较高。
  • 文档README 包含部署、配置、API 接口和模型能力说明,较完整。
  • 社区有 1332 星和 891 叉,37 个开放 issue,社区有一定规模但不算大。
  • 上手难度提供 Docker Compose 和交互式安装脚本,上手步骤清晰。

使用前注意

  • · 许可证为 CNC-1.0 非商业许可,商用前需确认合规性。
  • · 依赖 Gemini Business 账号,账号获取和使用需遵守相关服务条款。
  • · 视频生成等能力可能受上游服务限制,实际可用性需自行验证。
  • · 默认使用 SQLite,生产环境建议配置 PostgreSQL 并做好数据备份。

主题标签

geminiopenai2apibusinesschatgpt