PublicAffairs GitHub avatar

openai-gemini

JavaScript
Gemini 转 OpenAI 代理PublicAffairs最近推送 2026年3月18日
模型推理与部署MIT3,6765,76020 issues

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

把 Gemini API 包装成 OpenAI 兼容接口,让只支持 OpenAI 的工具免费用上 Gemini。

这是一个用 JavaScript 写的代理服务,将 Gemini API 转换为 OpenAI API 格式。它支持 Serverless 部署,可以免费部署到 Vercel、Netlify、Cloudflare Workers 等平台,也支持本地运行。项目采用 MIT 许可证,已有 3600 多 star。

推荐指数

4.0

适合想低成本使用 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. 第 1 步

    接收 OpenAI 格式请求

    代理服务监听 /v1/chat/completions 等端点,解析请求体。

  2. 第 2 步

    转换为 Gemini 格式

    将 messages、参数等映射为 Gemini API 的对应字段。

  3. 第 3 步

    调用 Gemini API

    使用用户提供的 Gemini API Key 向 Google 发起请求。

  4. 第 4 步

    转换响应并返回

    把 Gemini 的响应转回 OpenAI 格式,支持流式输出。

快速上手

  1. 1

    获取 Gemini API Key

    在 Google AI Studio 创建 API Key。

  2. 2

    部署到 Vercel

    点击部署按钮或使用 Vercel CLI 部署。

    vercel deploy
  3. 3

    配置客户端

    在支持 OpenAI 的软件中填入代理地址和 API Key。

  4. 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)尚未实现。

主题标签

chatgpt-apigemini-aiopenaiproxyserverlessgemini