HAJIMI Gemini API 代理使用教程

HAJIMI Gemini API 代理使用教程

hajimi 项目地址: https://gitcode.com/gh_mirrors/ha/hajimi

1. 项目介绍

HAJIMI 是一个基于 FastAPI 构建的 Gemini API 代理，它旨在提供一个简单、安全且可配置的方式来访问 Google 的 Gemini 模型。该项目适用于在 Hugging Face Spaces 上部署，并支持openai api格式的工具集成。本项目基于CC BY-NC 4.0许可开源，用户在使用时需遵守相应的规则。

2. 项目快速启动

要快速启动 HAJIMI 项目，请按照以下步骤操作：

首先，确保您的环境中已经安装了 Python 和 pip。然后克隆项目仓库并安装所需的依赖：

git clone https://github.com/wyeeeee/hajimi.git
cd hajimi
pip install -r requirements.txt

接下来，设置环境变量。您可以根据需要修改以下环境变量：

export PASSWORD=your_password  # 设置密码
export MAX_REQUESTS_PER_MINUTE=30  # 设置每分钟最大请求数
export MAX_REQUESTS_PER_DAY_PER_IP=600  # 设置每天每个 IP 最大请求数
# 其他需要的环境变量

最后，运行项目：

uvicorn main:app --reload

现在，HAJIMI 代理应该已经在本地运行，并通过默认的端口（8000）提供服务。

3. 应用案例和最佳实践

应用案例

• API 密钥轮询和管理：自动轮询 API 密钥，有效管理密钥使用。
• 模型列表接口：提供模型的列表，方便用户选择和调用。
• 聊天补全接口：支持流式和非流式的聊天补全，与 OpenAI API 格式兼容。

最佳实践

• 设置强密码：为了安全性，请确保设置一个强密码。
• 调整速率限制：根据实际使用情况调整速率限制，避免服务被滥用。
• 监控 API 配额：确保您的 Gemini API 密钥具有足够的配额。

4. 典型生态项目

目前，HAJIMI 项目已经有一些典型的生态项目，包括但不限于：

• Docker 部署：使用 Docker 容器化部署 HAJIMI 代理。
• Termux 部署：在手机上使用 Termux 环境部署 HAJIMI 代理。
• Zeabur 部署：在 Zeabur 平台上部署 HAJIMI 代理（需付费）。
• Claw Cloud 部署：在 Claw Cloud 平台上部署 HAJIMI 代理。

通过这些生态项目，用户可以更加灵活地部署和使用 HAJIMI 代理。

hajimi 项目地址: https://gitcode.com/gh_mirrors/ha/hajimi