工具介绍
这是什么
FreeLLMAPI 是一个可自托管的 LLM API 聚合网关:你把各家提供商申请到的免费 API Key 填进它的管理面板,它对外只暴露一个 OpenAI 风格的 /v1 地址,由内置路由器在多个模型与提供商之间选路、限流和故障转移。项目以 MIT 协议开源,提供 Docker、源码、桌面安装包等多种运行方式。
README 声称可聚合 87 家免费提供商、1,313 个免费模型端点、合计约每月 101 亿 token 的免费额度。上述数字、端点清单和额度均为项目方自述,本站未实测,具体可用范围待核查。
主要能力(据 README)
- OpenAI 兼容接口:
/v1/chat/completions、/v1/responses、/v1/completions、/v1/images/generations、/v1/videos/generations、/v1/audio/speech、/v1/audio/transcriptions、/v1/embeddings、/v1/models,支持流式与非流式。 - Anthropic Messages 接口
/v1/messages,供 Claude Code 一类客户端接入。 - 可选的原生 Gemini
/v1beta与 Ollama 模拟接口。 - 六种路由策略、按模型的实时评分、429/5xx 自动冷却并切到下一个模型、Key 轮换。
- 按
(平台, 模型, Key)统计 RPM/RPD/TPM/TPD,尽量不让请求超过各家免费上限。 - Fusion:把同一提示词并行发给多个模型,再由裁判模型合成答案(虚拟模型名
fusion)。 - 提供商 Key 以 AES-256-GCM 加密存于本地 SQLite,应用侧只看到一个统一 Bearer Token。
- 管理面板含 Keys、回退链、Playground、Analytics;另有
/mcpMCP 服务器与/v1/docs接口文档页。 - 桌面版为菜单栏/托盘应用,本地运行路由与面板。
适用人群
- 想在一个入口横向试用多家免费模型、免去逐个对接 SDK 的个人开发者。
- 需要给 Claude Code、Codex CLI、Cline、Aider、Continue 等客户端临时找一个低成本后端的人。
- 做原型、脚本、爬虫辅助、批处理小任务,能接受质量和延迟波动的场景。
不适合:对稳定性、延迟、合规和 SLA 有要求的生产业务;项目自身也定位为个人实验用途。
环境门槛
- 源码/服务端运行:Node.js 20.18.0 以上(package.json 限制
<25),npm 10 以上;或使用 Docker;README 称可跑在 Windows、macOS、Linux 及树莓派一类 ARM 小设备上,空闲内存约 40MB(未实测)。 - 桌面版:macOS 12 Monterey 及以上(arm64/x64)、Windows 安装包、Linux 的 deb/rpm/AppImage/tar.xz,均在 Releases 中提供。
- 必须自己到各提供商注册账号并申请 API Key;注册门槛、是否需要信用卡、地区限制均待核查。
- 桌面版为单用户本地模式,默认无登录;服务端安装需要邮箱加密码账号,忘记密码的验证码打印在服务端日志里。
安装与启动(摘自 README,本站未执行验证)
- 官方一行脚本(需已装 Docker):
curl -fsSL https://freellmapi.co/install.sh | bash;README 说明脚本会创建~/freellmapi、生成加密密钥、拉取镜像并启动容器,重复执行会保留.env。执行前建议自行阅读脚本内容。 - 完成后打开
http://localhost:3001,在 Keys 页添加各提供商 Key,在回退链页面调整顺序,并在 Keys 页顶部取得统一 API Key。 - 客户端把
base_url指向http://localhost:3001/v1,模型名可填auto、auto:fast、auto:smart、某个 profile 或具体模型 ID。 - README 还给出一个客户端配置示例命令:
npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>,称会自动备份并合并已有配置。 - Windows 用户可从 Releases 下载
.exe安装器;源码开发用npm install && npm run dev。
费用
- 软件本体 MIT 许可,自托管免费。
- 项目另有一项代号 Premium 的付费项,仅用于获取「实时模型目录」更新;README 标价为 19 美元/年或 49 美元一次性终身,属项目方自述,价格与购买流程待核查。
- 免费安装使用月度快照目录,README 称新模型会比实时目录晚 30 天进入,功能不做删减。
- 真正决定成本的是上游各家免费层的条款与额度,这些由提供商单方面制定,随时可能调整或取消。
国内使用注意
- 上游以海外服务为主(Google、Groq、Cerebras、Mistral、Cloudflare、Cohere、NVIDIA、HuggingFace、OpenRouter、Z.ai 等),境内网络可直连性、延迟与是否需要额外网络条件均待核查。
- README 在 ModelScope 条目标注「需要绑定阿里云 cn」,具体绑定方式与可用性待核查。
- 各提供商免费层是否接受中国大陆手机号或支付方式注册、是否限制访问地区,均待核查。
- 把多家免费额度集中转售或对外提供接口,可能与部分提供商条款冲突;本项目 README 与仓库描述均标注为个人实验用途,正式使用前请自行核对各家服务条款。
已知限制(据 README,未实测)
- 没有前沿旗舰模型,延迟波动大,不提供 SLA。
- 免费额度按天/按月刷新,README 称免费池在同一天后段会因热门模型额度耗尽而质量下降,UTC 零点重置。
- 上游随时可能下线模型或改配额,需要依赖目录更新跟上。
- 目录更新需要路由器访问
freellmapi.co拉取签名清单,该下载地址在境内的可达性待核查。
许可与版权
MIT License,Copyright (c) 2026 Tashfeen Ahmed。使用、修改与再分发须保留原始版权声明与许可文本。本页面为本站编辑整理的中文待审核草稿,不是原作者中文文档,也不代表作者立场;文中功能、数字与安装步骤均来自项目 README 与 Releases 说明,未经本站实测。
来源与加工说明
来源:https://github.com/tashfeenahmed/freellmapi
许可证:MIT
依据 GitHub 原始资料由 AI 整理的中文待审核草稿,未经本站实测。原始版权与许可归原作者;未声明许可不代表允许转载或再分发。
来源类型:GitHub;授权范围待核验
运行与适配
如何理解使用难度?
- 直接使用:通常打开网页或登录账号即可使用。
- 简单配置:需要填写密钥、连接服务或导入配置。
- 需要部署:需要安装依赖、配置运行环境或自行部署。
- 技术开发:需要编程、接口集成或开发调试。
格数越多,使用门槛越高;具体要求请看下方说明。
国内可用性待核验
访问来源 ↗国内使用情况与网友核验
网友核验 用户经验分享
与站长实测独立,不代表官方认证或本站已实测。
最近核验:暂无有效核验。参与人数按当前项目有效身份去重;不同核验项分别统计,不合并成用户总结果。仅统计审核通过且未过期的记录。
分项统计、有效期与样本量
| 核验项目 | 有效人数 | 成功 / 部分 / 失败 / 无法判断 | 成功率 | 最近核验 / 有效期 |
|---|---|---|---|---|
| 官方网站访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| GitHub 仓库访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 安装与运行 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 官方服务国内连接 / MCP 连接 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 国内网络情况 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 国内模型兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 自定义 API | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外服务依赖 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外账号要求 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 中文界面 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 客户端兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 账号及费用信息 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
成功率 = 成功 ÷(成功 + 部分成功 + 失败);无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项,成功表示核查结论与资料吻合,具体观察另行统计;不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。
最近有效核验
暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。
查看全部有效核验 →