gemini-business2api

把 Gemini 商业版变成 OpenAI 接口，多账号负载均衡，还能生成图片视频。

这是一个将 Google Gemini Business 服务转换为 OpenAI 兼容 API 的开源项目。它解决了开发者无法直接使用 Gemini 商业版能力、且需要统一接口调用多家 AI 服务的问题。核心能力包括：提供 OpenAI 格式的 REST API，支持多账户自动负载均衡，集成图像生成、视频生成和文件解析等多模态功能，并兼容 ChatGPT 生态工具。项目基于 Python 实现，部署简单，可无缝替换现有 OpenAI API 调用，降低迁移成本。适合需要高可用、多模态 AI 能力的开发者和企业用户。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1330

维护状态低维护

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队yukkcat

所属国家

官网地址https://gemini-business2api.nanohajimi.mom

GitHubhttps://github.com/yukkcat/gemini-business2api

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言Python

技术栈/模型2api,business,chatgpt,gemini,openai

GitHub 星标★ 1330

30天Star增速

HF 下载量

上线时间2025-12-23 00:00:00

最近更新2026-09-23 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：Docker 6 步

环境要求

已安装 Docker 与 Docker Compose（推荐用 docker compose 部署）
Python 3.11（仅本地模式需要，Docker 模式无需本机 Python）
Git（用于克隆仓库）
Linux 环境且具备 sudo 权限（使用交互式安装脚本时）

安装与启动步骤

1克隆仓库

把项目源码拉到本地并进入项目目录。

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

2复制环境变量文件

从示例文件生成实际使用的 .env，后续在其中填写密钥。
```
cp .env.example .env
```
3填写环境变量

编辑 .env，至少设置 ADMIN_KEY（后台管理密钥）、服务端口与 DATABASE_URL。
4启动 2API 主服务

用 Docker Compose 启动主服务与管理后台，会暴露 7860 端口并挂载 ./data。
```
docker compose up -d
```
5按需启动刷新 worker

refresh-worker 默认不启动，需要账号刷新能力时用 refresh profile 拉起。
```
docker compose --profile refresh up -d
```
6或使用安装脚本

不想手动操作时，可执行官方交互式脚本，按提示选择 Docker/Python、端口、ADMIN_KEY 等。
```
curl -fsSL https://raw.githubusercontent.com/yukkcat/gemini-business2api/main/deploy/install.sh | sudo bash
```

关键配置

配置项	必填	说明	示例
`ADMIN_KEY`	是	管理后台登录密钥，安装脚本中会提示填写	`admin-xxxxxxxx`
`DATABASE_URL`	否	数据库连接地址，安装脚本中会提示填写
`服务端口`	否	对外服务端口，docker 结构默认暴露 7860	`7860`

如何确认成功

容器启动后访问 http://localhost:7860 可打开管理后台，并能用 ADMIN_KEY 登录即成功。

常见问题

Q：refresh-worker 是必须启动的吗？

A：不是。默认不启动，只有需要账号刷新能力时，才通过 docker compose --profile refresh up -d 或安装脚本 --with-refresh 启用。

Q：安装脚本里的 --with-refresh 是什么意思？

A：它只是把“是否启用 refresh-worker”这一选项默认预设为开启，并不代表另一套独立安装流程。

Q：还能用项目里的注册机吗？

A：不能。自 v0.3.0 起注册机、注册流程已从主线移除，主仓库只保留 2API 主服务、管理后台和可选 refresh-worker。

Q：如何固定安装某个正式版本？

A：把脚本地址中的 main 换成版本号标签即可，例如 v0.3.3。

注意事项

自 v0.3.0 起主线只保留 2API 主服务、管理后台和可选 refresh-worker，注册与刷新执行链路已拆出。
服务通过 ./data 目录持久化数据，docker-compose 中主服务与 refresh-worker 读取同一个 ./data。
当前稳定版本为 v0.3.3，许可证为 CNC-1.0，使用前请确认授权范围。

核心亮点

多账户轮询负载均衡，提升请求吞吐和稳定性
支持图像/视频生成及文件解析，扩展多模态应用场景
API 兼容 OpenAI 格式，可无缝接入现有 ChatGPT 工具链

不足之处

依赖 Gemini 商业版账号，非免费使用
文档/社区待观察

适用场景

将现有 OpenAI 应用迁移到 Gemini 以降低成本
需要多模态生成能力（图像/视频）的统一 API 网关
多账号管理避免单点限流，保障服务高可用

替代项目

one-api、new-api、LiteLLM

项目介绍

gemini-business2api 是基础设施领域的开源项目，由 yukkcat 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,330）位列前 30%，在基础设施分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,309 增加到 1,330，净增 21。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-23。从国内网络环境看，当前已无法正常访问。

它主要面向的使用场景是：将现有OpenAI应用迁移到Gemini以降低成本。同类可对比的替代方案包括 one-api、new-api、LiteLLM。

上一篇：XMem

下一篇：Free-GPT4-WEB-API