SuperAPI AI 工具集

freebuff2api-openai-proxy

编程与开发

查看项目

更新于 10-15 21:05

技能介绍

用途:Freebuff2API 是一个用 Go 编写的 OpenAI 兼容代理服务器,把标准 OpenAI API 请求翻译为 Freebuff 后端格式,使任何 OpenAI 兼容客户端、SDK 或 CLI 无需修改即可调用 Freebuff 的免费模型。

主要能力:暴露标准 OpenAI 端点(如 /v1/chat/completions);动态随机化客户端指纹以模拟官方 Freebuff SDK 行为;按可配置间隔轮换多个认证令牌;可通过可选 HTTP 代理转发出站流量;以多架构 Docker 镜像发布,便于部署。

获取令牌:方式一,访问 https://freebuff.llm.pm 登录并复制显示的令牌;方式二,使用 Freebuff CLI:npm i -g freebuff,运行 freebuff 并按提示登录,令牌存于 Linux/macOS 的 ~/.config/manicode/credentials.json 或 Windows 的 C:\Users<username>.config\manicode\credentials.json,复制其中 authToken 值作为 AUTH_TOKENS。

部署:推荐 Docker,例如 docker run -d --name freebuff2api -p 8080:8080 -e AUTH_TOKENS="$FREEBUFF_TOKEN" ghcr.io/quorinex/freebuff2api:latest;多令牌用逗号分隔;可加 -e API_KEYS 与 -e HTTP_PROXY。也支持 Docker Compose、从源码构建(需 Go 1.23+,go build -o freebuff2api .,./freebuff2api -config config.json)。

配置:config.json 或环境变量,含 LISTEN_ADDR(默认 :8080)、UPSTREAM_BASE_URL(默认 https://codebuff.com)、AUTH_TOKENS、ROTATION_INTERVAL(默认 6h)、REQUEST_TIMEOUT(默认 15m)、API_KEYS(默认空即开放访问)、HTTP_PROXY。环境变量优先于 JSON 文件。唯一 CLI 参数为 -config。

使用:将客户端指向 http://localhost:8080,可用 curl、Python/Node.js 的 openai SDK、LangChain 等,支持流式输出。若 API_KEYS 为空则无需 Authorization 头。

适用场景:希望以 OpenAI 接口统一接入 Freebuff 免费模型、需要多账号令牌轮换提升吞吐、或在企业/区域网络下经 HTTP 代理访问的场景。

限制:需自行获取有效 Freebuff 令牌,令牌过期或上游拒绝会返回 403;默认请求超时 15 分钟,长补全需调大;API_KEYS 为空时代理开放访问,存在安全风险;资料未提供收费、价格与性能数据。