@formata/limitr

中文文档
0.8.5发布于 2026/11/09Apache-2.0TypeScriptES Module近 30 天下载 2206

限制 信用 和在你的AI产品内计费:一个开源引擎,它决定每个客户能做什么,花费你多少,以及每一次通话,在程序内计费什么.

中文使用文档
文档目录9 节
  1. 快开始
  2. 开你的帐,不是开你的帐
  3. 你用它来建造什么
  4. 限制网络:服务代理付费
  5. 每一笔交易,按书面执行
  6. 为 AI 编码代理制作
  7. 自我接待:独自一人,或与限制云
  8. 学多点
  9. 许可证

Limitr
npm downloads license docs stars

在你的人工智能产品里 限制 信用和开账单.
一个开源引擎,它决定每一次通话,每个客户能做什么,花费多少,以及账单多少. 你以此为基础:你的规则,你的UI,你的编码代理. 限制者云保持每个计划,价格,合同的活性,没有释放.

限制器是用于使用控制和计费的开源引擎. 它测量使用量(AI的代号按型号排列,API调用, 代理运行,座位,任何你计算的东西, 执行计划和限制, 价格每一次调用 花费你和什么 充电,并告诉你的代码 账单。 这是一个图书馆,不是服务: 它运行在你的进程中,在节点,邦,德诺, 或浏览器,所以没有部署或自主机,在请求中间也没有网络呼叫. 已经建成了 对于没有遵循计划的使用, 这是大多数AI的使用.

快开始

npm i @formata/limitr
import { Limitr } from '@formata/limitr';

const limitr = await Limitr.new(`
policy: {
    credits: {
        ai_token: {
            price: { amount: 0.00002 }      // you charge $20 per million tokens
            overhead_cost: 0.000008         // the model costs you $8 per million
        }
    }
    plans: {
        pro: {
            default: true
            entitlements: {
                export_pdf: {}                                                   // a feature flag
                chat: { limit: { credit: 'ai_token', mode: 'soft', value: 1_000_000, resets: true, reset_sch: 'monthly:1' } }
            }
        }
    }
}`);

limitr.addHandler('billing', (name, value) => {
    if (name === 'meter-overage') console.log('bill it:', JSON.parse(value as string).overage_price);
});

await limitr.ensureCustomer(userId);
if (await limitr.allow(userId, 'chat', tokens)) {
    // call the model
}

这是一个计划 每月AI的象征性津贴, 超龄账单通过它, 和比值每一次呼叫。 这个 教程 简而言之,在15年的基础上, 可运行的章节.

开你的帐,不是开你的帐

定价从不静坐. 成本、使用和交易 每月改变, 每一个改变 降落在您的代码和 你已经有客户了。 大多数计费平台都很快启动, 并且将您的定价放到他们的系统中: 使用是 发送到一个供应商, 数到他们的服务器, 一个事件一次, 之后它发生。 自己来控制, 并且花费工程时间 每个计划和每笔交易.

限制器是没有构建的控制器. 引擎是你的,就像你的密码:

  • 在你的应用程序里. 每一次检查都是在工作开始前进行的 没有网络通话.
  • 整个任务都是价钱,一次不打一次电话. 一项任务是数十次跨模型、工具和供应商通话. 引擎看到每个人与客户,他们的计划, 和任务的成本到目前为止,所以价格和限制 整个任务,它运行.
  • 和你的生意有关. 计划,价格,成本,限制, 和每个客户的交易在一个政策文件.
  • 扩展像代码. 您自己的定价功能, 特征条件, 规则, 和工具运行在策略中, 写 内 楼梯。 。 。 .
  • 安全在你的流程. 策略运行沙盒:没有文件或环境,没有网络,除非允许(和 永远不要你的私人网络 除非你列出它, 和时间和记忆限制 每一次通话。 引擎已经密封 当它装入时,所以一个政策可以建立在它之上,但不能改变它.
  • 在每一个呼叫中, 按你收取的费用和付出的代价定价.
  • 从不分享你的收入, 和你的,如果你离开: 有限制云或没有它, 它是相同的引擎.

你用它来建造什么

  • 一种政策中的任何定价模式: 按用途、座椅、信用、平面图,或混合图、图和图.
  • AI的功能保持盈利: 按型号计算的费用、每个呼叫额、呼叫前的预计使用率和开支 用来停止逃跑的盖子.
  • 特色旗帜和推出: 杀开关、百分率推出和规则 每一个呼叫,旁边的计划,与 测量它们的事件.
  • 海关交易和合同: 给一个客户一个他们计划没有的特征, 带走一个,或者改变 他们的界限,随着期限的届满, 没有新的计划 每一笔交易。 很多顾客签的合约 写成一次 在政策中做出规定,并分配给每个人.
  • 属于一起的客户: 裁判将一个用户放在一个团队和一个团队中,无论你如何模拟它. 一个用户 没有自己的计划是它的org计划, 与org的交易,座位,和共享预算.
  • 预付贷项: 过期、转帐和转帐的信贷包,按自己的费率在各地使用.
  • 支付使用费后的利率限制 : 保护你的基础设施,不碰客户付出的代价.
  • 计费活动: 超龄 限值 和阈值 被传送到你的密码上.
  • 服务人员可以购买: 将您的 API 出售给代理商和其他服务 限制网络( 下), 由 同样的政策.

限制网络:服务代理付费

需要预测,搜索,或翻译的代理通常首先需要账户和API密钥. 与 限制者网络,一个服务机构根据限制者政策公布其计划和路线,以及一个代理商(或任何应用软件,或 带有政策服务) 凭单(笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) 服务仪表就像任何 客户,以凭证的花费作为硬帽;代理商获得服务路线作为工具;以及每一个请求和 收据是签名的,所以双方都持有同样的记录. 没有交换密钥, 没有集成工作 。 可选操作员 (Limitr Cloud是一,为您设置在 Limitr.cloud() 添加共享状态 服务器、跨服务的预算、身份和发现。 限制网络协议:从 src/network 编辑 教程轨道。 。 。 .

每一笔交易,按书面执行

客户的签名超过他们的计划:每月250 000 API电话,SSO,审计日志 从您的业务计划,没有 出口。 把交易写成一条规则 交给每个签名的客户 其条件适用于下一个 电话,没有新的计划 没有工程票:

rules: {
    acme_2027: {
        label: 'Acme 2027'
        given: { sso: {}, audit_log: { plan: 'business' } }
        taken: { exports: {} }
        overrides: { api: { credit: 'request', value: 250_000, resets: true, reset_sch: 'monthly:1' } }
    }
}
await limitr.setCustomerRules('acme', ['acme_2027']);
await limitr.entitlementSource('acme', 'api'); // { access: 'plan', limit: 'rule:acme_2027', customer: 'acme' }

对于每个客户来说,顺序是相同的:先是自己的变化,后是规则(最高优先),后是规则 计划。 规则也可以限制开支,一个规则不能发明一种权利:给予总是使用计划的定义. A 类 用户在它的org计划中,也会得到org的规则.

为 AI 编码代理制作

Npm包 3个技能 node_modules/@formata/limitr/skill数字 : limitr (政策参考文献 引擎函数,以及每个事件, limitr-ts (类型脚本 SDK),和 limitr-network (限额网). 这个 第四个, stof (语言政策写入) 与斯多夫在 node_modules/@formata/stof/skill/stof。 。 。 . 用你的编码代理来对着它们和它 可以正确写出,审查,调试政策和集成,而不是猜测. 限制技能也被包装为拉链 content/ 用于上传到代理服务器.

自我接待:独自一人,或与限制云

没有可部署的限制服务器 。 引擎是 npm 软件包,运行在你的应用 无论是你的应用运行, 开源 (Apache 2. 0)并免费. "自我接待" 限制是 npm i @formata/limitr 还有你的保险单 这个 同样的政策和相同的呼叫 与或不限制云工作, 这样你就可以从一个开始移动到另一个.

一个人 (单位:千美元)Limitr.new(policy)),您拥有发动机周围的部件:

  • 政策 就像密码一样被审查并部署.
  • 客户状态 在您的数据库中保存 : 保存每个客户, 如其事件所言, 并恢复它 loadCustomers 当你的应用启动。 给客户的裁判(其团队和Org)装入,因为其计划、交易和 共享的盖子通过它们. 在你的应用程序中运行 显示整个循环.
  • 计费期 随您的订阅setCustomerPeriod),或日历.
  • 计费 来自于事件: 超龄,极限,和阈值 到你的代码,随着价格 和每个成本,为花纹 或者任何你开的账单.

与 限制云 (单位:千美元)Limitr.cloud({ token })这些零件随它而来 每张支票 仍在运行中 :

  • 限制分析师, 每页都有你身边的特工 它写和测试你的政策, 将一个签了合同在 从订单表格中解答有关客户、使用量和边距的问题,以及 显示价格变化会对真实的账单有什么影响,然后公布。 它在草案中发挥作用,并提出其他建议: 在应用之前,任何内容都不会被公布或更改.
  • 政策 您编辑、审查并发布您的应用程序的每一份运行中的副本, 没有部署, 并滚回.
  • 客户 留给你的, 顾客们的裁判们 都准备和他们一起上船.
  • 计费: 分类账,发票通过你自己的花旗, 和帐单 向客户和每个人的帐单 一张发票.
  • 合同: 规则,包括坡道、收费、承诺和表彰.
  • 分析: 客户的用途、成本和利润率、账户、特征、模型或任务.

限制者云有一个免费计划, 从来没有分享你账单中的一部分: 开始免费 并让分析员 写你的第一个政策.

学多点

定价模式你不太合适吗? 和创始人谈谈。 。 。 .

许可证

阿帕奇2.0 (英语). 见 自由主义 详细情况.




Limitr

版本与发布记录

@formata/limitr 共发布 63 个版本,首次发布于 2026/02/06;过去 12 个月发布了 63 个版本。

版本发布日期距今
0.8.5latest2026/11/097 天前
0.8.32026/11/0610 天前
0.8.22026/11/0411 天前
0.8.12026/10/3115 天前
0.8.02026/10/3115 天前
0.7.52026/10/2819 天前

关于 @formata/limitr 的常见问题

@formata/limitr 是什么?

限制 信用 和在你的AI产品内计费:一个开源引擎,它决定每个客户能做什么,花费你多少,以及每一次通话,在程序内计费什么.

如何安装 @formata/limitr?

在项目目录运行 npm install @formata/limitr,或使用 pnpm add / yarn add / bun add。

@formata/limitr 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@formata/limitr 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@formata/limitr 可以商用吗?

@formata/limitr 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@formata/limitr 的下载量有多少?

根据 npm 官方下载统计,@formata/limitr 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,206 次,日均约 74 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@formata/limitr 还在维护吗?

最新版本 0.8.5 发布于 2026/11/09(7 天前);至今共发布 63 个版本,其中过去 12 个月发布了 63 个;首次发布于 2026/02/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。