跳转到主要内容

​
适合谁？

本指南适用于开发 AI 产品、API 服务或按用量收费的开发者。常见场景包括：
业务类型示例
AI API 服务LLM API 代理、图像生成、语音识别
AI SaaSAI 写作助手、AI 代码补全、AI 翻译
AI Agent 平台自动化工作流、数据分析 Agent
API 服务支付处理、消息服务、数据查询

​
Waffo Pancake 的收费方式

Waffo Pancake 不提供内置的用量计量功能，但你可以用两种主方式完成 AI 产品收费：订阅制 和 按需购买。这两种方式也可以组合使用。

​
方式 1：订阅制

创建不同层级的订阅商品，每个层级包含不同的 token、请求次数或调用额度。
以下价格仅为示例，请根据你的实际业务和成本设置。
方案月费Token 配额适合
Starter$9/月100K tokens个人开发者
Pro$49/月1M tokens小团队
Scale$199/月10M tokens企业用户
适合：
  • 按月或按年提供持续访问权限
  • 每个套餐包含固定额度
  • 希望通过升级套餐来提升额度

​
方式 2：按需购买

通过一次性订单或 priceSnapshot 动态定价，在结账时按实际购买量或实际用量收费。 适合：
  • 购买额外 token / credits
  • 超出套餐后的补差收费
  • 按任务、按调用或按报价收费

​
动态定价（Checkout Session）

通过 priceSnapshot 在创建结账会话时传入动态价格，实现按实际用量收费。 
const session = await client.checkout.createSession({
  storeId: "store_id",
  productId: "usage-product-id",
  productType: "onetime",
  currency: "USD", // 替换为你的货币
  priceSnapshot: {
    amount: calculatedAmount, // 根据用量动态计算
    taxIncluded: false,
    taxCategory: "saas",
  },
});

​
外部计量工具

使用专业的计量工具追踪用量，配合 Waffo Pancake 完成收费。

​
推荐计量工具

New API

API 聚合管理平台，支持多模型 key 分发、用量追踪和额度控制。Waffo Pancake 合作伙伴。

​
推荐组合方式

大多数 AI 产品并不是只选一种收费方式，而是把订阅制和按需购买组合起来。

​
组合方案：订阅基础额度 + 按需补充

这是最常见、也最容易被用户理解的 AI 收费方式。 设置：
  1. 创建分层订阅商品（如 Starter / Pro / Scale）
  2. 每个订阅层级包含固定 token、请求次数或调用额度
  3. 使用外部计量系统追踪实际消耗
  4. 当用户超出包含额度时，通过一次性订单或 priceSnapshot 收取额外费用
适用业务：
  • AI API 服务
  • AI SaaS
  • AI Agent 平台
控制台工作流：
  • 在 订阅 中查看活跃套餐
  • 在 支付 中查看额外购买或超额收费
  • 在 分析 中同时追踪订阅收入和按需收入

​
关键 Webhook 事件

事件操作
subscription.activated设置初始 token/请求配额
subscription.updated调整配额以匹配新方案
subscription.canceled撤销 API 访问或降级到免费层级
subscription.past_due降低配额或限制 API 调用频率
order.completed发放额外 token 额度（超额购买）
API 详情请参考 API 参考文档。

​
测试

1

创建测试商品

在测试模式下设置订阅商品和按需购买商品。
2

使用测试卡订阅

使用 4576 7500 0000 0110 订阅每个层级。
3

模拟用量

测试你的用量追踪和配额限制逻辑。
4

测试按需收费

验证超出配额后的动态定价和按需购买流程。

​
上线清单

  • 为每个层级创建了订阅商品
  • 已创建按需购买或超额收费商品
  • 定价和配额文档清晰
  • 用量追踪/计量工具已集成
  • 配额限制正常工作
  • 升级/降级流程已测试
  • 按需收费流程已验证
  • 商品已发布到生产环境

​
下一步

运营 SaaS 订阅

了解更多订阅管理知识

配置 Webhook 通知

通过 Webhook 自动化配额管理