> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 应用计费

> 为 AI 应用和 API 服务设计灵活的计费方案

## 适合谁？

本指南适用于开发 AI 产品、API 服务或按用量收费的开发者。常见场景包括：

| 业务类型        | 示例                    |
| ----------- | --------------------- |
| AI API 服务   | LLM API 代理、图像生成、语音识别  |
| AI SaaS     | AI 写作助手、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` 在创建收银台会话时传入动态价格，实现按实际用量收费。

```typescript theme={"system"}
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 完成收费。

***

## 推荐计量工具

<Card title="New API" icon="bolt" href="https://github.com/QuantumNous/new-api">
  API 聚合管理平台，支持多模型 key 分发、用量追踪和额度控制。Waffo Pancake 合作伙伴。
</Card>

***

## 推荐组合方式

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

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

这是最常见、也最容易被用户理解的 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 参考文档](/zh/api-reference/introduction)。

***

## 测试

<Steps>
  <Step title="创建测试商品">
    在测试模式下设置订阅商品和按需购买商品。
  </Step>

  <Step title="使用测试卡订阅">
    使用 `4576 7500 0000 0110` 订阅每个层级。
  </Step>

  <Step title="模拟用量">
    测试你的用量追踪和配额限制逻辑。
  </Step>

  <Step title="测试按需收费">
    验证超出配额后的动态定价和按需购买流程。
  </Step>
</Steps>

***

## 上线清单

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

***

## 下一步

<CardGroup cols={2}>
  <Card title="运营 SaaS 订阅" icon="repeat" href="/zh/guides/subscriptions">
    了解更多订阅管理知识
  </Card>

  <Card title="配置 Webhook 通知" icon="webhook" href="/zh/guides/webhooks">
    通过 Webhook 自动化配额管理
  </Card>
</CardGroup>