AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日
把 Gemini API 包装成 OpenAI 兼容接口,让只支持 OpenAI 的工具免费用上 Gemini。
这是一个用 JavaScript 写的代理服务,将 Gemini API 转换为 OpenAI API 格式。它支持 Serverless 部署,可以免费部署到 Vercel、Netlify、Cloudflare Workers 等平台,也支持本地运行。项目采用 MIT 许可证,已有 3600 多 star。
推荐指数
适合想低成本使用 Gemini 模型又不想改代码的开发者,部署简单但需注意平台限制。
总 Star 排名
#1552
雷达追踪的 3,958 个 AI 仓库中
创建于
2024
2024年2月19日
核心亮点
1免费使用 Gemini
利用 Gemini 免费额度,通过代理让 OpenAI 工具直接调用。
2Serverless 部署
一键部署到 Vercel、Netlify、Cloudflare 等平台,无需维护服务器。
3兼容 OpenAI 接口
支持 chat/completions、embeddings、models 等主要端点。
4支持多模态
可处理图片和音频输入,按 OpenAI 规范传递。
5内置网络搜索
在模型名后加 :search 即可启用 Gemini 的搜索工具。
适用场景
让现有 OpenAI 工具使用 Gemini
例如:在 ChatBox 等客户端中把 API 地址改为代理地址,即可用 Gemini 模型对话。
个人免费搭建 AI 接口
例如:部署到 Vercel,获得一个免费的 OpenAI 兼容端点供个人项目调用。
本地开发测试
例如:用 Node 运行 npm run start,在本地调试调用 Gemini 的代码。
它是怎么工作的
第 1 步
接收 OpenAI 格式请求
代理服务监听 /v1/chat/completions 等端点,解析请求体。
第 2 步
转换为 Gemini 格式
将 messages、参数等映射为 Gemini API 的对应字段。
第 3 步
调用 Gemini API
使用用户提供的 Gemini API Key 向 Google 发起请求。
第 4 步
转换响应并返回
把 Gemini 的响应转回 OpenAI 格式,支持流式输出。
快速上手
- 1
获取 Gemini API Key
在 Google AI Studio 创建 API Key。
- 2
部署到 Vercel
点击部署按钮或使用 Vercel CLI 部署。
vercel deploy - 3
配置客户端
在支持 OpenAI 的软件中填入代理地址和 API Key。
- 4
本地运行(可选)
安装依赖后启动本地服务。
npm install && npm run start
适合谁
- 想免费使用 Gemini 模型的个人开发者
- 已有 OpenAI 兼容工具但想换用 Gemini 的用户
- 需要快速搭建 AI 代理服务的开发者
不太适合
- 需要企业级 SLA 或高并发的生产环境
- 无法获取 Gemini API Key 的用户
成熟度
- 活跃度最近一次推送在 2026 年 3 月,持续维护。
- 文档README 详细说明了部署和使用方法,但部分细节需参考外部文档。
- 社区3600 多 star,5700 多 fork,issue 数量较少。
- 上手难度提供一键部署按钮和本地运行命令,上手简单。
同类项目怎么选
- gemini-openai-proxy另一个将 Gemini 转为 OpenAI 接口的代理,但部署方式可能不同。
- openai-api-proxy通用代理项目,可能支持多种后端,不专一于 Gemini。
使用前注意
- · 需要自行申请 Gemini API Key,且免费额度有限。
- · 部署到 Serverless 平台时需注意各平台的功能限制(如超时、内存)。
- · 代理服务不提供浏览器直接访问,需在客户端配置。
- · 部分 OpenAI 参数(如 logit_bias、logprobs)尚未实现。
