Delete README.md
Browse files
README.md
DELETED
|
@@ -1,82 +0,0 @@
|
|
| 1 |
-
# 🚀 HAJIMI Gemini API Proxy
|
| 2 |
-
|
| 3 |
-
这是一个基于 FastAPI 构建的 Gemini API 代理，旨在提供一个简单、安全且可配置的方式来访问 Google 的 Gemini 模型。适用于在 Hugging Face Spaces 上部署，并支持openai api格式的工具集成。
|
| 4 |
-
|
| 5 |
-
# 本项目基于CC BY-NC 4.0许可开源，需遵守以下规则
|
| 6 |
-
- 您必须给出适当的署名，提供指向本协议的链接，并指明是否（对原作）作了修改。您可以以任何合理方式进行，但不得以任何方式暗示许可方认可您或您的使用。
|
| 7 |
-
- 您不得将本作品用于商业目的，包括但不限于任何形式的商业倒卖、SaaS、API 付费接口、二次销售、打包出售、收费分发或其他直接或间接盈利行为。
|
| 8 |
-
|
| 9 |
-
### 如需商业授权，请联系原作者获得书面许可。违者将承担相应法律责任。
|
| 10 |
-
|
| 11 |
-
### 感谢[@warming-afternoon](https://github.com/warming-afternoon)，[@任梓樂](https://github.com/rzline)在技术上的大力支持
|
| 12 |
-
|
| 13 |
-
### 错误自查
|
| 14 |
-
|
| 15 |
-
遇到问题请先查看以下的 **错误自查** 文档，确保已尝试按照其上的指示进行了相应的排查与处理。
|
| 16 |
-
|
| 17 |
-
- [错误自查](./wiki/error.md)
|
| 18 |
-
|
| 19 |
-
### 使用文档
|
| 20 |
-
- [Claw Cloud部署的使用文档（推荐，免费，手机电脑均可使用）](./wiki/claw.md) 感谢[@IDeposit](https://github.com/IDeposit)编写
|
| 21 |
-
- [huggingface 部署的使用文档（手机电脑均可使用）](./wiki/huggingface.md)
|
| 22 |
-
- [docker部署的使用文档（服务器自建使用）](./wiki/docker.md) 感谢[@北极星星](https://github.com/beijixingxing)编写
|
| 23 |
-
- [termux部署的使用文档（手机使用）](./wiki/Termux.md) 感谢[@天命不又](https://github.com/tmby)编写
|
| 24 |
-
- [zeabur部署的使用文档(需付费)](./wiki/zeabur.md) 感谢**墨舞ink**编写
|
| 25 |
-
- [vertex模式的使用文档](./wiki/vertex.md)
|
| 26 |
-
|
| 27 |
-
### 更新日志
|
| 28 |
-
* v0.1.6
|
| 29 |
-
* 为并发模式提供缓存，并发中除了返回的成功请求，其他成功请求将被缓存，若下次请求与本次请求一致，将首先使用缓存内容
|
| 30 |
-
* 为请求添加硬限制，超过每日限定次数的key将不再发送请求，若所有key都达到次数限制，将随机选择一个key请求
|
| 31 |
-
* 添加空响应计数，单次请求空响应重试超过一定次数将直接跳出
|
| 32 |
-
* 修复联网模式bug（感谢**yoolieer**），现在能够正常的启用停用联网模式了
|
| 33 |
-
* 新增环境变量`MAX_EMPTY_RESPONSES`，为空响应重试次数，默认为5
|
| 34 |
-
* 修复若干bug
|
| 35 |
-
* v0.1.5
|
| 36 |
-
* 实现vertex热切换，现在在前端面板就可以切换vertex模式与ai studio模式了
|
| 37 |
-
* 为vertex模式实现假流式，环境变量与ai studio模式的假流式相同，均为`FAKE_STREAMING`
|
| 38 |
-
* 优化前端界面
|
| 39 |
-
* 修复若干bug
|
| 40 |
-
* v0.1.4beta
|
| 41 |
-
* 为大部分配置项适配热更新，可实时调整配置
|
| 42 |
-
* 前端界面新增适配热更新相关ui界面，可直接调整配置（在前端界面修改的数据在重启后会失效）
|
| 43 |
-
* 适配 vertex ai（基于gzzhongqi/vertex2openai项目开发），在启用vertex模式并配置vertex凭证后，项目将切换为vertex请求模式
|
| 44 |
-
* 新增环境变量`ENABLE_VERTEX`用于启用vertex模式，初始默认为false
|
| 45 |
-
* 新增环境变量`GOOGLE_CREDENTIALS_JSON`用于配置vertex凭证，默认为空
|
| 46 |
-
|
| 47 |
-
|
| 48 |
-
|
| 49 |
-
* 历史版本更新日志请查看[update](./wiki/update.md)
|
| 50 |
-
|
| 51 |
-
## ✨ 主要功能：
|
| 52 |
-
|
| 53 |
-
### 🔑 API 密钥轮询和管理
|
| 54 |
-
|
| 55 |
-
### 📑 模型列表接口
|
| 56 |
-
|
| 57 |
-
### 💬 聊天补全接口：
|
| 58 |
-
|
| 59 |
-
* 提供 `/v1/chat/completions` 接口，支持流式（streaming）和非流式响应，与 OpenAI API 格式兼容。
|
| 60 |
-
* 自动将 OpenAI 格式的请求转换为 Gemini 格式。
|
| 61 |
-
|
| 62 |
-
### 🔒 密码保护（可选）：
|
| 63 |
-
|
| 64 |
-
* 通过 `PASSWORD` 环境变量设置密码。
|
| 65 |
-
* 提供默认密码 `"123"`。
|
| 66 |
-
|
| 67 |
-
### 🚦 速率限制和防滥用：
|
| 68 |
-
|
| 69 |
-
* 通过环境变量自定义限制：
|
| 70 |
-
* `MAX_REQUESTS_PER_MINUTE`：每分钟最大请求数（默认 30）。
|
| 71 |
-
* `MAX_REQUESTS_PER_DAY_PER_IP`：每天每个 IP 最大请求数（默认 600）。
|
| 72 |
-
* 超过速率限制时返回 429 错误。
|
| 73 |
-
|
| 74 |
-
### 🧩 服务兼容
|
| 75 |
-
|
| 76 |
-
* 提供的接口与 OpenAI API 格式兼容,便于接入各种服务
|
| 77 |
-
|
| 78 |
-
## ⚠️ 注意事项：
|
| 79 |
-
|
| 80 |
-
* **强烈建议在生产环境中设置 `PASSWORD` 环境变量，并使用强密码。**
|
| 81 |
-
* 根据你的使用情况调整速率限制相关的环境变量。
|
| 82 |
-
* 确保你的 Gemini API 密钥具有足够的配额。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|