One Balance：通过 Cloudflare AI Gateway 智能管理 AI API 密钥的负载均衡工具

One Balance 是一个开源工具，基于 Cloudflare AI Gateway 构建，专注于帮助开发者高效管理多个 AI API 密钥。它通过智能轮询和健康检查分配 API 请求，优化配额使用，降低密钥封禁风险。用户可快速部署到 Cloudflare Worker，支持 Google AI Studio、OpenAI 等多种 AI 提供商。项目在 GitHub 上开源，配置简单，适合个人开发者或团队使用。

功能列表

• 通过 Cloudflare AI Gateway 转发 API 请求，保护密钥安全。
• 智能轮询多个 API 密钥，自动分配请求以最大化配额。
• 支持模型级限流，精准识别并暂时屏蔽超限模型。
• 自动创建和管理 D1 数据库，存储密钥状态。
• 提供统一 API 请求入口，兼容多种 AI 提供商。
• 一键部署到 Cloudflare Worker，生成专属 Worker URL。
• 智能错误处理，区分分钟级和天级配额，自动冷却。

使用帮助

安装流程

One Balance 依赖 Cloudflare Worker 部署，过程简单但需基础技术知识。以下是详细步骤：

1. 克隆项目仓库
   打开终端，运行以下命令克隆 One Balance 仓库：

   git clone https://github.com/glidea/one-balance.git
   cd one-balance
   

2. 安装依赖
   使用 pnpm 安装项目所需依赖：

   pnpm install
   

3. 配置授权密钥
   设置环境变量 AUTH_KEY，用于验证 API 请求。
   • Mac/Linux ：运行以下命令：

   AUTH_KEY=your-super-secret-auth-key pnpm run deploycf
   

   • Windows (PowerShell) ：运行以下命令：

   $env:AUTH_KEY = "your-super-secret-auth-key"; pnpm run deploycf
   

4. 部署到 Cloudflare Worker
   运行部署命令后，需登录 Cloudflare 的 wrangler 工具（需提前安装）。若未登录，按提示完成登录。部署会自动创建 D1 数据库，并生成 Worker URL，例如：

   https://one-balance-backend.<your-subdomain>.workers.dev
   

5. 验证部署
   部署成功后，访问生成的 Worker URL（例如 https://one-balance-backend.workers.dev）。在中国大陆可能需使用 VPN。使用浏览器或 curl 命令测试 API 是否正常响应。

使用方法

One Balance 通过 Cloudflare AI Gateway 代理 API 请求，连接到 Google AI Studio 或 OpenAI 等服务。以下是操作流程：

1. 发送 API 请求
   使用生成的 Worker URL 发送请求。例如，调用 Google Gemini 2.5 Pro 模型的请求格式为：

   https://one-balance-backend.workers.dev/api/google-ai-studio/v1beta/models/gemini-2.5-pro:generateContent
   

   请求需在 Header 中包含 AUTH_KEY，示例：

   curl -H "Authorization: Bearer your-super-secret-auth-key" \
   https://one-balance-backend.workers.dev/api/google-ai-studio/v1beta/models/gemini-2.5-pro:generateContent
   

2. 管理密钥状态
   One Balance 使用 D1 数据库存储密钥状态，包括：
   • Active ：密钥可用。
   • Cooling Down ：模型触发限流，暂时冷却。
   • Blocked ：密钥被封禁，停止使用。
     系统根据分钟级或天级配额（如 Google AI Studio 的配额）自动调整冷却时间，例如天级配额触发后冷却 24 小时。
3. 查看请求日志
   在 Cloudflare 控制台查看 AI Gateway 的请求日志，包括成功率、错误类型等。One Balance 自动处理 429（速率限制）错误，切换到可用密钥。

特色功能操作

• Cloudflare AI Gateway 转发 ：通过 Gateway 代理请求，隐藏原始密钥，降低封禁风险。
• 智能轮询 ：自动选择可用密钥发送请求，无需手动管理。
• 模型级限流 ：当某模型触发限流，系统暂停该模型请求，切换其他可用模型或密钥。
• 快速部署 ：一键部署到 Cloudflare Worker，生成 Worker URL 即可使用。
• 错误处理 ：识别配额错误，自动冷却并切换密钥，保障服务连续性。

注意事项

• 确保网络可访问 Cloudflare 服务，中国大陆用户可能需 VPN。
• 不要共享 AUTH_KEY，以免请求跟踪错误导致限流。
• 定期登录 Cloudflare 控制台，更新密钥或优化配额策略。

应用场景

1. AI 开发者高效管理密钥
   开发者持有多个 AI API 密钥，需最大化配额使用。One Balance 通过 Cloudflare AI Gateway 智能分配请求，简化管理。
2. 企业 AI 应用高可用性
   企业开发聊天机器人或内容生成工具，需稳定 API 调用。One Balance 确保密钥轮询和错误处理，防止服务中断。
3. 开源社区协作
   开源项目团队可通过 One Balance 共享密钥池，降低封禁风险，提高开发效率。

QA

1. One Balance 支持哪些 AI 提供商？
   支持 Google AI Studio、OpenAI 等，具体参考 Cloudflare AI Gateway 文档（https://developers.cloudflare.com/ai-gateway/providers）。
2. 如何降低密钥封禁风险？
   使用 Cloudflare AI Gateway 代理请求，隐藏密钥信息。避免共享 AUTH_KEY，定期检查配额。
3. 部署失败如何处理？
   确认 wrangler 已登录，检查 AUTH_KEY 设置。查看终端日志或 GitHub Issues 寻求帮助。
4. 如何支持其他 AI 提供商？
   修改请求转发逻辑，参考 Cloudflare AI Gateway 文档，添加新提供商的 API 格式。