基于信用的计费

​

什么是基于信用的计费？

• AI 和 LLM 平台：根据计划级别授予令牌或生成信用
• API 服务：分配 API 调用信用并设置超额定价
• 基础设施平台：发行计算时间或存储信用
• 通信服务：为每个订阅提供信息或分钟数信用
• 具有消费层的 SaaS：将包含的使用量捆绑到信用池中

​

核心概念

​

信用类型

​

信用生命周期

​

授予来源

​

创建信用

• 自定义单位 - 定义您自己的指标（令牌、API 调用、计算时间）。需要 单位名称（例如，“平台令牌”）和 精度 设置。
• 法定货币信用 - 信用代表实际货币价值。需要 单位货币 选择（美金，欧元，英镑，INR，等等）。

• 0 - 整数（适合可计数项，如 API 调用）
• 1 - 一位小数 (0.0)
• 2 - 两位小数 (0.00) - 默认
• 3 - 三位小数 (0.000)
• 最多为 10 - 高精度单位（例如，分数令牌或微用量）

• 7天, 30天 (默认), 60天, 90天, 自定义, 或 从不

• 最大转移百分比（0%-100%）- 限制可携带多少
• 转移时间范围 - 转移信用的有效时长（例如，1个月）
• 最大转移次数 - 信用被没收之前的最大连续转移次数

• 超额限制 - 客户可以使用的超余额最大信用
• 单价 - 启用超额时每额外信用的成本（附带币种选择）

• 重置时原谅超额（默认）- 超出信用限额的使用会被跟踪但不计费。每个周期余额重置。
• 账单时计费超额 - 超出信用限额的使用在下一个发票上计费，然后余额重置。
• 带过不足额 - 超出信用限额的使用会作为负余额带入下一个周期。
• 带过不足额（自动还款） - 不足额带入并在下一个周期自动从新信用中偿还。

​

向产品附加信用

​

订阅产品

​

一次性付款产品

​

基于使用的计费产品

​

信用设置

​

转移

​

超额

​

到期

​

使用信用的计费

​

基于计量的信用扣除如何工作

1. 您的应用程序发送使用事件 - 每个事件包括客户 ID、事件名称和元数据
2. 计量器聚合事件 - 使用计数、求和、最大值或最后一个值进行聚合
3. 信用自动扣除 - 一个后台工作程序每分钟处理事件，使用您配置的费率将计量单位转换为信用，并使用 FIFO 顺序（最老授予优先）从客户的余额中扣除
4. 超额被跟踪 - 如果信用余额达到零并且启用了超额，系统会跟踪超额使用以便在周期结束时计费

​

计量器面板

​

客户体验

​

结帐

​

客户门户

• 可用余额 - 以显著展示当前信用余额
• 信用标签 - 在不同信用类型之间切换（例如，“OpenAI 信用”，“使用令牌”）
• 最近交易 - 包括日期、交易 ID、类型、金额和运行余额的完整历史记录

​

订阅详情

• 每个计费周期的信用分配（例如，“每个周期 1000 信用”）
• 剩余余额（例如，“剩余 7500 信用”）
• 下次信用发放的续订日期
• 使用历史 标签，显示计量器级别的消耗单位、阈值、单位价格和总成本

​

交易详情

​

管理信用

​

仪表板视图

​

信用权利列表

​

客户信用详情

• 信用选择器 - 在不同信用权利之间切换
• 可用余额 - 以大而显著的显示当前余额
• 应用信用/借方 - 按钮用于手动调整客户的余额
• 最近交易 - 包括日期、交易ID、类型、金额和运行余额的完整账本

​

手动调整

​

信用账本

​

Webhooks

​

API 管理

​

集成示例

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode', // defaults to 'live_mode'
});

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_ai_pro_plan',
      quantity: 1,
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

await client.usageEvents.ingest({
  events: [{
    event_id: `gen_${Date.now()}`,
    customer_id: 'cus_abc123',
    event_name: 'ai.generation',
    timestamp: new Date().toISOString(),
    metadata: { model: 'gpt-4', tokens: 1500 }
  }]
});

​

真实案例

• 信用类型：自定义单位（“AI 令牌”）
• 精度：0（完整令牌）
• 转移：最大 25%，1 个月时间范围
• 超额：启用，账单时计费超额
• 计量器：ai.generation，按 tokens 字段聚合求和

• 信用类型：自定义单位（“API 调用”）
• 精度：0（完整调用）
• 转移：禁用
• 超额：开发者以上计划允许超额（重置时原谅），免费计划不允许超额
• 计量器：api.request，使用计数聚合

• 信用类型：自定义单位（“GB-小时”）
• 精度：2（两位小数）
• 转移：最大 50%，只转移一次
• 超额：启用，限制 200%
• 计量器：storage.usage，使用聚合求和

​

最佳实践

• 从简单开始：从单一种信用类型和无转移开始。根据客户反馈和使用模式增加复杂性。
• 设定明确的期望：在产品页面和客户门户中突出显示信用分配、剩余余额和超额定价。
• 使用有意义的单位：将信用命名为它们代表的内容（例如，“API 调用”，“AI 令牌”）而不是泛泛之词。这有助于客户理解价值。
• 认真配置过期：较短的过期时间窗（7 天）可激发紧迫感，但可能让客户感到沮丧。较长的时间窗（30-90 天）对于大多数 SaaS 产品更为用户友好。
• 监控低余额：设置低余额阈值以在客户用完前提醒他们，从而减少意外超额费用。
• 在测试模式下测试：创建信用，将其附加到测试产品，并在上线前模拟完整的购买 → 使用 → 扣除 → 过期周期。