来源:技术爬爬虾的Gemini中转教程:

搭建 Gemini API 中转服务

在使用 Google Gemini API 进行开发时,有时可能会遇到网络访问问题、需要统一管理 API Key、或者希望在请求中加入自定义逻辑(如日志记录、限速等)。这时,搭建一个 Gemini API 中转服务(Proxy)就成为一个非常有用的解决方案。

本文将介绍如何利用 tech-shrimp/gemini-playground 这个开源项目,快速搭建一个简单的 Gemini API 中转服务。这个项目提供了一个基础的框架,可以帮助我们将客户端的请求转发到 Google 官方的 Gemini API,并在中间进行处理。

为什么需要中转服务?

搭建 API 中转服务可以带来以下好处:

  1. 解决网络访问问题: 如果直接访问 Gemini API 存在困难,可以通过一个网络畅通的服务器作为中转。
  2. 统一管理 API Key: 将 API Key 集中配置在中转服务上,客户端无需各自持有 Key,提高安全性。
  3. 添加自定义逻辑: 可以在中转服务中实现请求日志记录、用户认证、流量控制、数据缓存等功能。
  4. 简化客户端配置: 客户端只需配置中转服务的地址,无需关心复杂的 API 端点和认证细节。

项目介绍

tech-shrimp/gemini-playground 项目提供了一个基于 Python 的简单 Web 服务,用于接收请求并将其转发给 Google Gemini API。它通常包含以下核心组件:

  • 一个 Web 框架(如 Flask 或 FastAPI)用于处理 HTTP 请求。
  • 用于与 Google Gemini API 交互的客户端库。
  • 处理请求转发和响应返回的逻辑。

通过修改和扩展这个项目,您可以根据自己的需求定制中转服务的行为。

搭建步骤

以下是搭建 Gemini API 中转服务的基本步骤:

第一步:克隆项目仓库

首先,将 tech-shrimp/gemini-playground 项目克隆到您的本地或服务器上:

1
2
git clone https://github.com/tech-shrimp/gemini-playground.git
cd gemini-playground

第二步:部署到Deno

  1. 准备一个Gemini API Key https://aistudio.google.com(免费)
  2. fork本项目
  3. 登录/注册 https://dash.deno.com/
  4. 创建项目 https://dash.deno.com/new_project
  5. 选择此项目,填写项目名字(请仔细填写项目名字,关系到自动分配的域名)
  6. Entrypoint 填写 src/deno_index.ts 其他字段留空
  7. 点击 Deploy Project
  8. 部署成功后获得域名,点开即用。域名同样可以作为Chat API的代理使用。

第三步:填写API Key

  1. 进入Deno分配的域名
  2. 把API Key填写到 请输入API Key 对话框中
  3. 点击 连接 按钮

第四步:Postman中转

  1. 打开Postman
  2. workspace->import->curl --location 'http://your.domain.com/v1/models' \--header 'Authorization: Bearer YOUR-GEMINI-API-KEY'
  3. 修改request name->http://your.domain.com/v1/models
  4. 修改header->Authorization: Bearer YOUR-GEMINI-API-KEY->(YOUR-GEMINI-API-KEY)改成你自己的API Key
  5. 点击 Send 按钮

第五步:使用

  1. API域名填写:https://your.domain.com/
  2. API Key填写:填写Google AI Studio API Key

参考资料:


© 2025 vmoranv 使用 Stellar 创建


😊本站2025.05.05日起🎉累计访问人次💻


614447.xyz