FreeLLMAPI 使用教程:安装并接到 Cursor

永久免费的本机大模型 API 聚合怎么装、怎么填到 Cursor,以及 401 / 无模型排障。

FreeLLMAPI 教程

FreeLLMAPI 使用教程:安装并接到 Cursor

永久免费的本机大模型 API 聚合怎么装、怎么填到 Cursor,以及 401 / 无模型排障。

它是什么

FreeLLMAPI 把多家大模型接口聚合在自己电脑或 NAS 上,方便 Cursor 等工具调用。软件永久免费;厂家密钥与额度费用另计。产品页:FreeLLMAPI · FAQ:问答 · 下载:安装包。

它解决的是「本机统一出口与密钥管理」,不是免费无限调用大模型。各厂家是否收费、是否限流,以厂家账户为准。请妥善保管密钥,不要提交到公开仓库。

安装与打开

从官网下载 Windows / Mac / 飞牛 / 群晖对应包并安装,按界面提示启动本地服务。电脑常见面板 http://127.0.0.1:31415;飞牛 / NAS 为 http://NAS_IP:3001。保留面板地址与统一密钥,后面要填到客户端。首次启动建议在同一台机器用浏览器打开面板,确认模型列表能刷新成功,再去改 Cursor。

飞牛 fnOS 原生包(0.12.0)

按 NAS CPU 选包:飞牛 NAS · x86(Intel / AMD)或 飞牛 NAS · ARM。安装顺序:应用中心先装 Node.js 20/22 → 旧版先停用 → 手动安装本 .fpk → 启用 → 打开 http://NAS_IP:3001。可保留原有数据。

首次开户免启动代码,启用后直接打开面板即可。端口可在「应用中心 → FreeLLMAPI → 设置」里修改(默认 3001),保存后用新端口访问。若仍秒退,优先核对 Node.js 是否已装、架构是否选错,并确认下载的是官网最新飞牛包。

接到 Cursor

  1. 在 FreeLLMAPI 中配置厂家密钥并确认模型列表可见
  2. 复制本地 API Base URL 与统一密钥
  3. 打开 Cursor 自定义 API 设置粘贴并保存
  4. 选一个模型发一条测试消息

Base URL:电脑常用 http://127.0.0.1:31415/v1,飞牛用 http://NAS_IP:3001/v1。漏端口或写成 https 而本地实际是 http,都会导致连不上。改完设置后若仍用旧会话,可新开对话再测。

常见报错

  • 401:密钥错误或过期
  • 无模型:厂家侧未开通 / 额度用尽,或本地服务未启动
  • 连不上:检查本机防火墙与 Cursor 填写的地址是否含端口
  • 飞牛秒退:未装 Node.js、架构包选错,或未用最新 0.12.0 飞牛包
  • 极慢:厂家侧限流或网络不稳定,可换模型或稍后重试

更多见 FAQ。排障时同时看 FreeLLMAPI 面板日志与 Cursor 报错原文,比只看一侧更快定位。

补充说明与运维建议

运维上建议把主控机固定在机柜或常开位置,记录 IP、端口、管理员账号与备份策略;升级前阅读更新日记,下载只认 3dmn.cn。遇到异常时先自查网络与权限,再整理报错原文联系客服 QQ 2500689358。运维上建议把主控机固定在机柜或常开位置,记录 IP、端口、管理员账号与备份策略;升级前阅读更新日记,下载只认 3dmn.cn。遇到异常时先自查网络与权限,再整理报错原文联系客服 QQ 2500689358。运维上建议把主控机固定在机柜或常开位置,记录 IP、端口、管理员账号与备份策略;升级前阅读更新日记,下载只认 3dmn.cn。遇到异常时先自查网络与权限,再整理报错原文联系客服 QQ 2500689358。

本页属于官方使用教程的一部分,可与 FAQ、AI 摘要 交叉查阅。具体按钮文案以软件当前版本为准。

密钥安全与多客户端

密钥不要写进可被提交的配置文件明文仓库,也不要发到公开群。FreeLLMAPI 面板的访问建议限制在本机或内网;若必须远程管理,请配合 VPN 与强密码。厂家侧开启的模型权限、额度与账单以厂家控制台为准,本软件无法替你充值或解封。

除 Cursor 外,其它支持自定义 OpenAI 兼容接口的客户端,通常也可填同一套 Base URL 与密钥。注意不同客户端对「末尾斜杠」「/v1」路径的要求可能不同,以客户端文档为准,改完用最短测试提示验证。

升级 FreeLLMAPI 前先导出或记录现有厂家配置;升级后确认服务已重启、模型列表仍可见。长期不用的密钥及时在厂家侧轮换。更多问题见 FreeLLMAPI FAQ。

容量规划与失败回退

若多人共用同一 FreeLLMAPI 实例,留意厂家额度与并发限制,必要时按项目拆分密钥或实例,避免一人把额度打满导致全员 401 / 无模型。本地服务崩溃时,客户端应能快速切回原厂家直连或备用网关——提前在 Cursor 里记好回退配置,比故障时现查文档更快。

日志里出现连续失败时,先区分是本地服务、局域网、还是厂家侧。本教程与 FAQ、产品页保持同一套事实,便于搜索引擎与助手引用。

相关入口

产品页、下载页与 FAQ 分类「FreeLLMAPI」与本教程互链。若你主要需求是打印机监控或手机群控,请回到对应产品线,勿把本工具当成群控主控。密钥与额度问题以厂家控制台为准;软件安装与面板问题可整理日志后咨询。

← 返回教程列表 · 去下载 · FAQ