ghcr.io/tashfeenahmed/freellmapi:sha-87fe9ae

FreeLLMAPI

每月74亿 tokens。34个免费LLM提供商。635个免费模型端点。一个OpenAI兼容端点。

聚合数十家提供商的免费额度，外加自定义的OpenAI兼容聊天、嵌入、图像和音频端点，统一通过单个/v1 API提供服务。密钥加密存储。路由器会为每个请求选择最佳可用模型，当某个提供商限流时自动故障转移到下一个，并跟踪按密钥使用量，确保不超过任何免费额度上限。

freellmapi.co · 浏览完整目录：474个模型系列，635个免费端点

English · 简体中文

路由器通过签名源自动更新自身模型目录：新的免费模型、配额变更和兼容性修复无需git pull即可生效。免费安装版获取月度快照，因此模型加入实时源后30天才能同步到免费版；高级路由器则可当天同步。 立即在freellmapi.co启用（每年19***，随时取消）。

---

快速开始

一行命令（需Docker环境 — 会设置~/freellmapi目录、生成加密密钥、拉取镜像并启动容器）：

curl -fsSL https://freellmapi.co/install.sh | bash

更愿意在通过管道执行bash前先阅读脚本内容？脚本在此。重新运行脚本是安全的：您的.env文件（及加密密钥）会被保留，且容器会更新至:latest标签。

打开 http://localhost:3001，在 密钥 页面添加提供商密钥，按需调整 Fallback Chain（回退链）的顺序，然后从 密钥 页面顶部获取统一API密钥。您的OpenAI SDK需指向此统一密钥。

在Windows上，最简单的方式是使用桌面版 **https://github.com/tashfeenahmed/freellmapi/releases/latest**（见下文）。在Android上，请参阅实验性的Termux指南。

其他所有内容 — Docker Compose配置、本地开发、声明式启动配置、生产环境构建、局域网访问及备份 — 均位于 docs/en/install/01-install.md。

高级版（实时目录）

路由会自动保持其模型目录的更新：它每天从 freellmapi.co 拉取一次签名目录，并将新模型、配额变更和提供商特性修复应用到本地数据库。您自己的启用/禁用选择和自定义提供商不会被更改，并且每次下载在应用前都会通过固定的 Ed25519 密钥进行验证。

当前目录跟踪 34 个提供商、474 个模型系列、635 个免费的提供商/模型端点（584 个聊天、41 个嵌入、7 个转录、3 个视频），以及大约每月 74 亿 tokens 的列出免费层级容量。可在 freellmapi.co/models 浏览完整列表。

免费安装会拉取相同的签名目录，但来自月度快照：模型在实时 feed 中发布 30 天后才会加入快照，因此免费版本目前落后约 303 个模型。没有任何功能过期或受限——只是更新会延迟。

高级版会在您运行的每个路由上保持签名目录的实时性。当提供商推出强大的免费模型、悄悄收紧配额或更改通信格式时，实时 feed 路由会在我们发布更新的当天收到。

立即在 freellmapi.co 激活 →

• 每年 19 ***或一次性 49 ***，终身使用。通过 Stripe 结账；可随时自助取消。
• 一个 fla_ 密钥适用于您运行的所有路由：桌面端、家庭实验室、树莓派。
• 在仪表板的 Premium 下激活；可在 freellmapi.co/manage 自助取消或管理账单。
• 路由本身始终保持 MIT 许可且完全免费。高级版仅包含实时 feed，它用于资助日常模型测试和目录维护，以确保目录正常运行。

目录服务器永远不会看到您的提示词、补全内容或提供商密钥——无论如何，路由始终完全自托管。

我忘记了服务器安装的密码。 在登录页面点击 忘记密码？ 。系统不会发送邮件链接，一次性验证码会打印到服务器日志中——可使用 docker compose logs -f freellmapi 命令查看（或在运行服务器的终端中，或桌面应用的日志文件中），然后在重置表单中输入该验证码。验证码有效期为 15 分钟。

日志位置？ Docker 环境下位于容器日志中；源码运行时位于终端中；桌面应用则位于 /logs/freeapi.log——可通过托盘菜单的 打开日志文件夹 访问。

如何卸载？ 移除应用（macOS 拖入废纸篓，Windows 进入 设置 → 应用，Docker 执行 docker compose down -v），然后删除数据目录：%APPDATA%\FreeLLMAPI\（Windows）、~/Library/Application Support/FreeLLMAPI/（macOS）或 ~/.config/FreeLLMAPI/（Linux）。卸载操作本身不会自动删除该文件夹。

按安装方式的详细解答：docs/en/install/01-install.md#faq-passwords-logs-uninstall。

限制

叠加免费额度存在实际权衡：无前沿模型、延迟不稳定、无服务等级协议（SLA）——且由于顶级模型达到每日使用上限，终端的实际智能水平在当天晚些时候会下降，并在 UTC 午夜重置。在基于此构建任何实际应用前，请阅读 docs/en/architecture/00-high-level-index.md#limitations 中的完整限制列表。

贡献

非常欢迎贡献者！请参阅 CONTRIBUTING.md 了解开发流程、PR 要求以及 AI/LLM 辅助贡献的政策（简版：欢迎，质量标准与其他 PR 一致）。适合新手的 PR：

• 添加提供商 — 复制 server/src/providers/openai-compat.ts 作为模板，将其接入 server/src/providers/index.ts，在 server/src/db/index.ts 中注册模型，在 server/src/__tests__/providers/ 中添加测试。
• 添加端点 — 如内容审核及其他 OpenAI 兼容接口。提供商基类可扩展新方法；适配器需声明支持的方法。
• 优化路由 — 成本感知路由（平衡最低成本、健康状态和最快速度）、更优的延迟加权优先级、区域固定。
• 仪表盘优化 — 分析页面图表、密钥轮换用户体验、从 .env 批量导入密钥。
• 文档 — 更多示例、Go/Rust 等语言的客户端库代码片段、Docker 或 Fly 的部署指南。

执行 npm install && npm run dev 可启动服务器（端口 :3001）和仪表盘（端口 :5173），均支持热模块替换（HMR）。如需可重复的开发环境，在 Bash 中使用 ./scripts/dev-bootstrap.sh，在 PowerShell 中使用 .\scripts\dev-bootstrap.ps1；两者均会保留已有的 .env 文件。PR 应包含测试，确保现有测试套件通过（npm test），并符合仓库中 .editorconfig 和 tsconfig 的默认配置。数据库迁移流程和完整贡献者流程详见 CONTRIBUTING.md。

贡献者

免责声明

本项目仅用于个人实验和学习，不适合生产环境。 免费额度的存在是为了让开发者能够基于其进行原型开发；它们并非稳定、受支持的推理基础设施，不应被视为生产级工具。如果基于 FreeLLMAPI 构建实际应用，请在发布前切换到付费 API。您与各上游提供商的关系受创建账户时接受的条款约束——当流量通过本项目代理时，这些条款仍然适用，您有责任遵守。

各提供商的服务条款（ToS）如何看待个人单用户代理——2026 年 5 月逐家审核——详见 docs/en/architecture/00-high-level-index.md#terms-of-service-review。

许可证

MIT