> ## 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：サブスクリプションティア + トークン/リクエストクォータ

異なるティアのサブスクリプション商品を作成し、各ティアに異なるトークンまたはリクエストクォータを設定します。

> 以下の価格は例です。実際のビジネスとコストに基づいて設定してください。

| プラン         | 月額      | トークンクォータ | 最適な用途    |
| ----------- | ------- | -------- | -------- |
| **Starter** | \$9/月   | 100Kトークン | 個人開発者    |
| **Pro**     | \$49/月  | 1Mトークン   | 小規模チーム   |
| **Scale**   | \$199/月 | 10Mトークン  | エンタープライズ |

### アプローチ2：チェックアウトセッションによる動的価格設定

チェックアウトセッション作成時に`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",
  },
});
```

### アプローチ3：外部計測ツール

専用の計測ツールで使用量を追跡し、Waffo Pancakeで課金を行います。

***

## 推奨計測ツール

<Card title="New API" icon="bolt" href="https://github.com/QuantumNous/new-api">
  API集約管理プラットフォーム。マルチモデルキー配布、使用量追跡、クォータ制御に対応。Waffo Pancake パートナー。
</Card>

***

## ビジネスシナリオ

<Note>
  以下はシナリオ例です。実際のビジネスに合わせて調整してください。
</Note>

### シナリオ1：AI APIサービス（トークンベース課金）

**設定：**

1. 階層型サブスクリプション商品を作成（Starter / Pro / Scale）
2. 各ティアにトークンクォータを含める
3. New API または自社システムでトークン消費を追跡
4. クォータに近づいたらアップグレードを促す

**Dashboardワークフロー：**

* **サブスクリプション**ページでアクティブなサブスクリプションを監視
* **アナリティクス**でティアごとの収益を追跡
* 顧客詳細で使用パターンを確認

### シナリオ2：AI SaaS（サブスクリプション + トークン枠）

**設定：**

1. トークン枠付きのサブスクリプション商品を作成
2. 商品メタデータに枠情報を保存
3. ユーザーが枠を超えた場合、`priceSnapshot`で超過課金を作成
4. Webhookで更新とクォータリセットを自動化

**Dashboardワークフロー：**

* サブスクリプションと単発注文を監視
* **アナリティクス**でサブスクリプション収益vs超過収益を追跡

### シナリオ3：AI Agentプラットフォーム（タスク/コール単位課金）

**設定：**

1. 一定回数のAgentコールを含むベースサブスクリプション商品を作成
2. Agent実行完了ごとにコールを記録
3. 含まれる回数を超えた場合、動的価格で単発注文を作成
4. New API でコール数とコストを追跡

**Dashboardワークフロー：**

* **決済**で顧客ごとの収益を確認
* Agentコールの成長トレンドを追跡

***

## 主要なWebhookイベント

| イベント                     | アクション                      |
| ------------------------ | -------------------------- |
| `subscription.activated` | 初期トークン/リクエストクォータを設定        |
| `subscription.updated`   | 新プランに合わせてクォータを調整           |
| `subscription.canceled`  | APIアクセスを取り消すか無料ティアにダウングレード |
| `subscription.past_due`  | クォータを削減またはAPIコールをスロットリング   |
| `order.completed`        | 追加トークン枠を付与（超過購入）           |

APIの詳細は[APIリファレンス](/ja/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="/ja/guides/subscriptions">
    サブスクリプション管理の詳細を学ぶ
  </Card>

  <Card title="Webhook通知を設定" icon="webhook" href="/ja/guides/webhooks">
    Webhookでクォータ管理を自動化
  </Card>
</CardGroup>