pingmike2/freebuff2api-wokers

解决的问题

本项目消除了使用 freebuff/codebuff 免费 AI 模型的繁琐。通常你需要管理登录令牌、跟踪每日使用限额（称为 Freebucks），并在账户用尽时手动切换。本服务将这些免费模型封装为标准的 OpenAI 兼容 API，因此你可以接入任何 OpenAI 或 Anthropic 客户端，让它为你处理所有复杂的账户、配额和会话管理。

工作原理

该服务作为一个轻量级服务器（无依赖的单文件）运行，接收 OpenAI 风格的请求。在后台，它维护一个 freebuff 账户池。当你发起聊天请求时，它会选择一个仍有额度的账户，使用一个会话（持续约一小时）来调用免费模型，并以标准格式返回结果。它还包含一个 Web 管理面板（位于 /admin），你可以在其中添加或删除账户令牌、为每个账户设置单独的代理、查看每个账户剩余的 Freebucks，以及调整 API 设置。所有更改均即时生效，无需重启。它支持 OpenAI 和 Anthropic API 格式，并提供用于正常运行时间监控的健康检查端点。

适用人群

适用于希望通过自己喜爱的 OpenAI 兼容工具使用免费 AI 模型（如 DeepSeek、Kimi、GLM 等）的开发者、折腾爱好者或小型团队，无需自行构建和维护账户轮询、配额跟踪和 API 网关。如果你需要管理多个免费账户以获得更多每日使用量，或者想以简单的方式将这些模型暴露给现有客户端，它将特别有用。

特性亮点

• 单文件、无依赖代码，可在 Docker 或 VPS 上运行。
• Web 管理面板，用于管理账户、代理、API 密钥，并实时查看 Freebucks 余额。
• 多账户自动切换：当一个账户达到每日限额时，它会自动冷却并切换到另一个账户。
• 智能会话重用：会话持续约一小时并固定在同一账户上，以最大化额度使用率。
• 兼容 OpenAI (/v1/chat/completions) 和 Anthropic (/v1/messages) API。
• 用于正常运行时间监控的健康检查端点。
• 推荐使用 Docker 部署；不建议使用 Cloudflare Worker 部署，因为存在账户被封禁的风险。