Concepts

计费模型

Nebutra 的三层套餐结构、使用量计量以及配额如何被强制执行。

套餐

Nebutra 提供三个预构建的计费层级。无需修改代码即可重命名、重新定价和添加功能。

FREE

$0/月

  • 1 个组织
  • 最多 3 名成员
  • 每月 1,000 次 API 调用
  • 每月 100 个 AI Token
  • 社区支持

PRO

$29/月

  • 无限组织
  • 最多 25 名成员
  • 每月 100,000 次 API 调用
  • 每月 500,000 个 AI Token
  • 邮件支持

ENTERPRISE

定制定价

  • 无限制
  • SSO / SAML / SCIM
  • 自定义数据驻留
  • SLA 保证
  • 专属支持

计量工作原理

使用量通过 @nebutra/metering 实时追踪,并通过 ClickHouse 聚合事件。每次 API 调用和 AI Token 使用都记录有:

  • tenant_id——哪个组织消耗了资源
  • metric_id——消耗了什么(api_callsai_tokens
  • quantity——消耗了多少
  • timestamp——何时发生

配额强制执行

配额在 API 网关层强制执行,在任何业务逻辑运行之前。当租户超出配额时,API 返回:

HTTP 429 Too Many Requests

{
  "success": false,
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "月度 API 调用配额已超出。升级到 PRO 可获得 100 倍更多调用次数。",
    "details": {
      "metric": "api_calls",
      "limit": 1000,
      "used": 1001,
      "reset_at": "2026-04-01T00:00:00Z"
    }
  }
}

用户在达到配额 80% 和 100% 时会收到事务性邮件警告。

查询配额

const quota = await metering.getQuota("org_123", "api_calls");
// → {
//     limit: 1000,
//     used: 847,
//     remaining: 153,
//     percentage: 0.847,
//     reset_at: "2026-04-01T00:00:00Z"
//   }

相关文档

How is this guide?

目录