为什么

Gemini API 提供一个免费层级，具有慷慨的配额限制，但仍然有许多工具仅支持 OpenAI API。

本项目提供了一个免费的、兼容 OpenAI 的个人代理端点。

无服务器？

尽管它运行在云端，但无需进行服务器维护。它可以轻松部署到各种云服务商，且完全免费 （配额足够满足个人使用需求）。

[!TIP] 你也可以选择在本地运行代理端点！（详见下文：本地运行 — 使用 Node、Deno 或 Bun）

如何开始

你需要一个属于自己的 Google API 密钥。

[!IMPORTANT] 即使你位于支持的地区之外， 仍然可以通过 VPN 获取一个 API 密钥。

按照以下说明将项目部署到任意一家云服务商。你需要先在该平台上注册一个账号。

如果你选择“一键部署”按钮，系统会引导你先 fork 该项目仓库，这是实现持续集成（CI）所必需的步骤。

使用 Vercel 部署

• 或者也可以通过 Vercel CLI 进行部署： vercel deploy
• 本地运行：vercel dev
• Vercel Functions 存在限制（使用 Edge 运行时）。

使用 Netlify 部署

• 或者也可以通过 Netlify CLI 这样部署： netlify deploy
• 本地运行：netlify dev
• 提供两种不同的 API 基础路径：
  • /v1（例如 /v1/chat/completions 端点） Functions 存在限制
  • /edge/v1 Edge functions 存在限制

使用 Cloudflare Workers 部署

• 或者也可以手动将 src/worker.mjs 文件的内容粘贴到 https://workers.cloudflare.com/playground（点击“Deploy”按钮）。
• 或者还可以通过 Cloudflare Wrangler CLI 进行部署： wrangler deploy
• 本地运行：wrangler dev
• Worker 存在限制。

使用 Deno 部署

详情请参见 此处。

本地运行 — 使用 Node、Deno 或 Bun

仅适用于 Node.js：npm install。

然后执行：npm run start / npm run start:deno / npm run start:bun。

开发模式（监听源码变化）

仅适用于 Node.js：npm install --include=dev

然后执行：npm run dev / npm run dev:deno / npm run dev:bun。

如何使用

如果你在浏览器中打开新部署的站点，只会看到一条 404 Not Found 的提示信息。这是正常的，因为该 API 并非设计用于直接通过浏览器访问。要使用它，你需要在你的软件设置中填入 API 地址和 Gemini API 密钥。

[!NOTE] 并非所有软件工具都允许覆盖 OpenAI 的端点，但许多工具是支持的 （不过这些设置有时可能隐藏得很深）。

通常，你需要以如下格式指定 API 基础路径： https://my-super-proxy.vercel.app/v1

相关的字段可能会被标记为“OpenAI 代理”。你可能需要在“高级设置”或其他类似部分中查找。或者，它也可能位于某个配置文件中（请参考相关文档获取详细信息）。

对于一些命令行工具，你可能需要设置环境变量，例如：

OPENAI_BASE_URL="https://my-super-proxy.vercel.app/v1"

或者：

OPENAI_API_BASE="https://my-super-proxy.vercel.app/v1"

模型

请求会优先使用名称以 “gemini-”、“gemma-” 或 “models/” 开头的模型。否则，将采用以下默认值：

• chat/completions：gemini-flash-latest
• embeddings：gemini-embedding-001

内置工具

要使用网页搜索工具，可以在模型名称后加上 :search（例如：“gemini-2.5-flash:search”）。

注意：annotations 消息属性尚未实现。

多媒体

根据 OpenAI 的[规范]，支持[Vision]和[音频]输入。通过 inlineData 实现。

[Vision]：https://platform.openai.com/docs/guides/images-vision?api-mode=chat&format=url#giving-a-model-images-as-input
[音频]：https://platform.openai.com/docs/guides/audio?example=audio-in&lang=curl#add-audio-to-your-existing-application
[规范]：https://platform.openai.com/docs/api-reference/chat/create

Gemini 特有的功能

Gemini 支持一些 OpenAI 模型不具备的功能，但可以通过 extra_body 字段启用。其中最值得注意的是 thinking_config。

更多细节请参阅 Gemini API 文档。

---

支持的 API 端点及适用参数

• chat/completions

  目前，大多数同时适用于两个 API 的参数都已经实现。

  • messages
    • content
    • role
      • "system"（=>system_instruction）
      • "user"
      • "assistant"
      • "tool"
    • tool_calls
  • model
  • frequency_penalty
  • logit_bias
  • logprobs
  • top_logprobs
  • max_tokens、max_completion_tokens
  • n（candidateCount <8，不支持流式输出）
  • presence_penalty
  • reasoning_effort
  • response_format
    • "json_object"
    • "json_schema"（仅支持 OpenAPI 3.0 规范中的部分结构）
    • "text"
  • seed
  • stop：字符串或数组（stopSequences [1,5]）
  • stream
  • stream_options
    • include_usage
  • temperature（OpenAI 范围为 0.0–2.0，而 Gemini 支持至无穷大）
  • top_p
  • tools
  • tool_choice
  • parallel_tool_calls（在 Gemini 中始终启用）
  • extra_body

• completions

• embeddings

  • dimensions

• models

openai-gemini 快速上手指南

openai-gemini 是一个开源代理工具，可将 Google Gemini API 转换为 OpenAI 兼容的接口。利用 Gemini API generous 的免费额度，让仅支持 OpenAI 格式的工具也能免费使用强大的 Gemini 模型。

环境准备

在开始之前，请确保满足以下条件：

1. Google API Key
   • 访问 Google AI Studio 获取个人 API Key。
   • 注意：如果您位于不支持的地区，可能需要使用网络工具（如 VPN）才能成功获取 Key。
2. 部署平台账号
   • 选择一个无服务器部署平台（推荐 Vercel、Netlify 或 Cloudflare），并注册账号。
   • 这些平台提供免费层级，适合个人使用且无需维护服务器。
3. 本地开发环境（可选）
   • 如果选择本地运行，需安装 Node.js、Deno 或 Bun 其中之一。
   • 若使用 Node.js 进行开发模式运行，需确保 npm 可用。

安装与部署

本项目主要通过云端无服务器平台部署，也可本地运行。

方案一：一键部署到 Vercel（推荐）

这是最简便的方式，适合大多数用户。

1. 点击以下按钮克隆仓库并部署：
2. 按照引导完成仓库 Fork 和部署流程（Fork 是持续集成所必需的）。
3. 部署完成后，记下生成的域名（例如 https://my-super-proxy.vercel.app）。

其他部署方式：

• Netlify: 点击 Deploy to Netlify 按钮。
• Cloudflare Workers: 点击 Deploy to Cloudflare Workers 按钮。
• 命令行部署 (以 Vercel 为例):

  vercel deploy
  

方案二：本地运行

如果您希望在本地测试或作为本地服务运行：

1. 克隆项目代码。
2. 安装依赖（仅 Node 环境需要）：

   npm install
   

3. 启动服务：

   # Node.js
   npm run start
   
   # Deno
   npm run start:deno
   
   # Bun
   npm run start:bun
   

4. 开发模式（监听文件变化）：

   # 先安装开发依赖
   npm install --include=dev
   
   # 启动开发服务
   npm run dev
   # 或 npm run dev:deno / npm run dev:bun
   

基本使用

部署成功后，直接在浏览器访问域名会显示 404 Not Found，这是正常现象，因为该服务专为 API 调用设计。

1. 配置客户端

在您使用的 AI 工具（如 Chatbox, NextChat, 或各类 CLI 工具）中，找到设置页面，修改以下两项：

• API Base URL (接口地址): 填入您的部署域名加上 /v1 后缀。 格式：https://<您的部署域名>/v1 示例：https://my-super-proxy.vercel.app/v1

• API Key: 填入您在“环境准备”阶段获取的 Google API Key。

提示：部分软件中该选项可能标记为 "OpenAI proxy"、"Custom Endpoint" 或在 "Advanced settings" 中。

2. 环境变量配置（命令行工具）

对于某些命令行工具，您可以通过设置环境变量来指定代理地址：

export OPENAI_BASE_URL="https://my-super-proxy.vercel.app/v1"
# 或者
export OPENAI_API_BASE="https://my-super-proxy.vercel.app/v1"

3. 模型使用规则

• 自动识别：如果请求中的模型名称以 gemini-, gemma-, 或 models/ 开头，将直接使用指定模型。
• 默认映射：
  • 聊天补全 (chat/completions) 默认使用：gemini-flash-latest
  • 嵌入向量 (embeddings) 默认使用：gemini-embedding-001

4. 高级功能示例

• 启用联网搜索：在模型名称后添加 :search。
  • 示例模型名：gemini-2.5-flash:search
• 使用 Gemini 特有功能：通过 extra_body 参数传递，例如开启思考模式 (thinking_config)。
• 多模态支持：支持传入图片和音频数据，符合 OpenAI 规范。