来源:技术爬爬虾的Gemini中转教程:
搭建 Gemini API 中转服务
在使用 Google Gemini API 进行开发时,有时可能会遇到网络访问问题、需要统一管理 API Key、或者希望在请求中加入自定义逻辑(如日志记录、限速等)。这时,搭建一个 Gemini API 中转服务(Proxy)就成为一个非常有用的解决方案。
本文将介绍如何利用 tech-shrimp/gemini-playground 这个开源项目,快速搭建一个简单的 Gemini API 中转服务。这个项目提供了一个基础的框架,可以帮助我们将客户端的请求转发到 Google 官方的 Gemini API,并在中间进行处理。
为什么需要中转服务?
搭建 API 中转服务可以带来以下好处:
- 解决网络访问问题: 如果直接访问 Gemini API 存在困难,可以通过一个网络畅通的服务器作为中转。
- 统一管理 API Key: 将 API Key 集中配置在中转服务上,客户端无需各自持有 Key,提高安全性。
- 添加自定义逻辑: 可以在中转服务中实现请求日志记录、用户认证、流量控制、数据缓存等功能。
- 简化客户端配置: 客户端只需配置中转服务的地址,无需关心复杂的 API 端点和认证细节。
项目介绍
tech-shrimp/gemini-playground 项目提供了一个基于 Python 的简单 Web 服务,用于接收请求并将其转发给 Google Gemini API。它通常包含以下核心组件:
- 一个 Web 框架(如 Flask 或 FastAPI)用于处理 HTTP 请求。
- 用于与 Google Gemini API 交互的客户端库。
- 处理请求转发和响应返回的逻辑。
通过修改和扩展这个项目,您可以根据自己的需求定制中转服务的行为。
搭建步骤
以下是搭建 Gemini API 中转服务的基本步骤:
第一步:克隆项目仓库
首先,将 tech-shrimp/gemini-playground
项目克隆到您的本地或服务器上:
1 | git clone https://github.com/tech-shrimp/gemini-playground.git |
第二步:部署到Deno
- 准备一个Gemini API Key https://aistudio.google.com(免费)
- fork本项目
- 登录/注册 https://dash.deno.com/
- 创建项目 https://dash.deno.com/new_project
- 选择此项目,填写项目名字(请仔细填写项目名字,关系到自动分配的域名)
- Entrypoint 填写
src/deno_index.ts
其他字段留空 - 点击 Deploy Project
- 部署成功后获得域名,点开即用。域名同样可以作为Chat API的代理使用。
第三步:填写API Key
- 进入Deno分配的域名
- 把API Key填写到
请输入API Key
对话框中 - 点击
连接
按钮
第四步:Postman中转
- 打开Postman
- workspace->import->
curl --location 'http://your.domain.com/v1/models' \--header 'Authorization: Bearer YOUR-GEMINI-API-KEY'
- 修改request name->http://your.domain.com/v1/models
- 修改header->Authorization: Bearer YOUR-GEMINI-API-KEY->(YOUR-GEMINI-API-KEY)改成你自己的API Key
- 点击
Send
按钮
第五步:使用
- API域名填写:https://your.domain.com/
- API Key填写:填写Google AI Studio API Key